Fresh 2026

SOP: Connect an Integration with Merge Link

Procedure to let an end user authorize a third-party integration and obtain a permanent account token.

Prerequisites

• Merge API key (server-side).
• Merge Link added to your frontend.

Procedure

1. Create a link token (backend). Call POST /link-token with your API key, the end user's id and email, and the categories to offer. Return the link_token to the frontend.
2. Open Merge Link (frontend). Initialize the Merge Link component with the link token. The user selects an integration and authorizes it.
3. Receive the public token. On success, Merge Link returns a public_token to your frontend.
4. Exchange for an account token (backend). Call POST /account-token/{public_token}. Store the returned account_token against the user record.
5. Use the account token. Pass it as X-Account-Token on every data request for this Linked Account.

Verification

• A new Linked Account appears in your Merge dashboard.
• A data request with the stored account token returns 200.

Related

• Merge Link
• Authentication Flow
• How Merge Works