Merge Docs

Authorize Single Integration

Direct your user to setup the configuration of a single integration.

Overview

You may want to customize your user experience to skip integration selection and guide your user directly to a specific integration's configuration step in Merge's integration authorization component.

API Keys preview

If you don't want to display a menu of integrations to your user and instead want to show them a single integration in Merge's component, you can do so using the code example below.

When you create a link token to initialize a linking flow session (as in Step 1 of the Get Started guide), add the identifier (found below) of the single integration you want to display in Merge's integration authorization component to the link_token request parameters.

A link_token created with this parameter will cause the linking flow to open directly to the integration configuration input form of just that integration.

Backend - Generate Link Token
1import requests
2
3# Replace api_key with your organization's production API Key
4def create_link_token(user, api_key):
5 body = {
6 "end_user_organization_name": user.organization_name,
7 "end_user_email_address": user.email_address,
8 "end_user_origin_id": user.id,
9 "categories": ["hris"],
10 # identifier of desired integration
11 "integration": "greenhouse",
12 }
13
14 headers = {"Authorization": f"Bearer {api_key}"}
15
16 link_token_url = "https://api.merge.dev/api/integrations/create-link-token"
17 link_token_result = requests.post(link_token_url, data=body, headers=headers)
18 link_token = link_token_result.json().get("link_token")
19
20 return link_token

HRIS Integration Identifiers

  • adp-workforce-now
  • alexishr
  • altera-payroll
  • azure-active-directory
  • bamboohr
  • breathe
  • ceridian-dayforce
  • charlie
  • charthop
  • deel
  • factorial
  • freshteam
  • google-workspace
  • gusto
  • hibob
  • hr-cloud
  • hr-partner
  • humaans
  • intellihr
  • jumpcloud
  • justworks
  • keka
  • lano
  • lucca
  • namely
  • nmbrs
  • officient
  • okta
  • onelogin
  • paycaptain
  • paychex
  • paylocity
  • peoplehr
  • personio
  • proliant
  • rippling
  • sage-hr
  • sap-successfactors
  • sapling
  • sesame
  • square-payroll
  • trinet
  • ukg-dimensions
  • ukg-pro
  • ukg-ready
  • workday
  • zenefits

ATS Integration Identifiers

  • applicantstack
  • ashby
  • bamboohr
  • bizmerlinhr
  • breezy
  • cats
  • clockwork
  • comeet
  • cornerstone-talentlink
  • engageats
  • eploy
  • fountain
  • freshteam
  • greenhouse
  • greenhouse-job-boards-api
  • homerun
  • hr-cloud
  • jazzhr
  • jobscore
  • jobsoid
  • jobvite
  • lano
  • lever
  • oracle-taleo
  • polymer
  • recruitee
  • recruiterflow
  • sage-hr
  • sap-successfactors
  • smartrecruiters
  • talentlyft
  • talentreef
  • teamtailor
  • ukg-pro-recruiting
  • workable
  • workday

Accounting Integration Identifiers

  • clear-books
  • freshbooks
  • microsoft-dynamics-365-business-central
  • netsuite
  • quickbooks-online
  • sage-business-cloud-accounting
  • sage-intacct
  • wave-financial
  • xero
  • zoho-books

Ticketing Integration Identifiers

  • asana
  • azure-devops
  • basecamp
  • clickup
  • freshdesk
  • front
  • github-issues
  • gitlab
  • gorgias
  • hive
  • intercom
  • ironclad
  • jira
  • jira-service-management
  • kustomer
  • linear
  • pivotal-tracker
  • salesforce-service-cloud
  • servicenow
  • shortcut
  • targetprocess
  • teamwork
  • trello
  • workfront
  • wrike
  • zendesk
  • zoho-bugtracker
  • zoho-desk

CRM Integration Identifiers

  • activecampaign
  • capsule
  • close
  • copper
  • freshsales
  • hubspot
  • insightly
  • microsoft-dynamics-365-sales
  • nutshell
  • pipedrive
  • pipeliner
  • salesflare
  • salesforce
  • sharpspring
  • teamleader
  • teamwork-crm
  • zendesk-sell
  • zoho-crm