Authorize Single Integration

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.

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