Authorize single integration

Overview

Naming a single integration on the link token skips integration selection and takes your user straight to that integration’s configuration step, instead of showing them a menu of integrations in Merge’s integration authorization component.

When you create a link token to initialize a linking flow session (as in Step 1 of the Get Started guide), add the identifier of the integration you want to display to the link_token request parameters. The linking flow then opens directly to the integration configuration input form of just that integration.

	import requests
# Replace api_key with your organization's production API Key
def create_link_token(user, api_key):
    body = {
        "end_user_organization_name": user.organization_name,
        "end_user_email_address": user.email_address,
        "end_user_origin_id": user.id,
        "categories": ["hris"],
        # identifier of desired integration
        "integration": "greenhouse",
    }
    headers = {"Authorization": f"Bearer {api_key}"}
    link_token_url = "https://api.merge.dev/api/integrations/create-link-token"
    link_token_result = requests.post(link_token_url, data=body, headers=headers)
    link_token = link_token_result.json().get("link_token")
    return link_token

Integration identifiers

These are the identifiers for every documented integration, grouped by category. Pass the one you want as the integration parameter shown above. An integration’s identifier is not always the same as the last segment of its documentation URL, so copy it from the list below or from your Merge Dashboard rather than deriving it from a page address.