Authorize 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.

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.

1
	import requests
2
3
# Replace api_key with your organization's production API Key
4
def 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

Integration identifiers

Below are examples of integration identifiers (slugs) organized by category. For a complete list of all available integrations, visit your Merge Dashboard.