Search...
Get StartedGuidesUse CasesAPI ReferenceSDKsIntegrations
Search docs...
⌘K
Log inGet a Demo
Merge API BasicsHR, Payroll, and Directory (HRIS)Recruiting (ATS)AccountingTicketingCRMMarketing AutomationFile StorageSupplemental Data
Overview
Common Models
Actions
GET/actionsPOST/actionsGET/actions/{id}GET/actions/meta/post
Automations
GET/automationsPOST/automationsGET/automations/{id}GET/automations/{parent_id}/recipientsGET/automations/meta/post
Campaigns
GET/campaignsPOST/campaignsGET/campaigns/{id}GET/campaigns/{parent_id}/contactsGET/campaigns/meta/post
Contacts
GET/contactsPOST/contactsGET/contacts/{id}GET/contacts/meta/post
Emails
GET/emailsGET/emails/{id}GET/emails/{parent_id}/recipients
Events
GET/eventsGET/events/{id}GET/events/{parent_id}/contacts
Lists
GET/listsPOST/listsGET/lists/{id}GET/lists/{parent_id}/subscribersGET/lists/meta/post
Messages
GET/messagesGET/messages/{id}GET/messages/{parent_id}/recipients
Templates
GET/templatesPOST/templatesGET/templates/{id}GET/templates/meta/post
Users
GET/usersGET/users/{id}
Linked Account
Account Details
Account Token
Delete Account
Issues
Linked Accounts
Link Token
Selective Sync
Beta
Data Management
Force Resync
Passthrough
Async Passthrough
Beta
Sync Status
Webhook Receivers
Org Management
Generate Key
Regenerate Key
Audit Trail
POST
/link-token

https://api.merge.dev/api/mktg/v1/link-token

US
EU

Creates a link token to be used when linking a new end user.


Body Parameters

end_user_email_addressString
Required
Your end user's email address. This is purely for identification purposes - setting this value will not cause any emails to be sent.

end_user_organization_nameString
Required
Your end user's organization.

end_user_origin_idString
Required
This unique identifier typically represents the ID for your end user in your product's database. This value must be distinct from other Linked Accounts' unique identifiers.

categoriesArray
Required
The integration categories to show in Merge Link.

integrationString
Optional
The slug of a specific pre-selected integration for this linking flow token. For examples of slugs, see https://docs.merge.dev/guides/merge-link/single-integration/.

link_expiry_minsInteger
Required
An integer number of minutes between [30, 720 or 10080 if for a Magic Link URL] for how long this token is valid. Defaults to 30.

should_create_magic_link_urlBoolean
Optional
Whether to generate a Magic Link URL. Defaults to false. For more information on Magic Link, see https://merge.dev/blog/integrations-fast-say-hello-to-magic-link.

To relink an account and prevent creating a new one:

Pass the existing account's end_user_origin_id to the /link-token endpoint.

Previous
Linked Accounts
Next Up
Selective Sync
Get Started

Introduction
Unified API
Linked Account
Merge Link
SDKs
API Reference

Merge API Basics
Supplemental Data

Merge ATS
Activities
Applications
Attachments
Candidates
Departments
Eeocs
Interviews
Job Interview Stages
Jobs
Offers
Offices
Reject Reasons
Scorecards
Screening Questions
Tags
Users

Merge HRIS
Bank Info
Benefits
Companies
Dependents
Employee Payroll Runs
Employees
Employer Benefits
Employments
Groups
Locations
Pay Groups
Payroll Runs
Time Off
Time Off Balances
Timesheet Entries
Teams

Merge Accounting
Accounting Periods
Accounts
Addresses
Attachments
Balance Sheets
Cash Flow Statements
Company Info
Contacts
Credit Notes
Expenses
Income Statements
Invoices
Items
Journal Entries
Payments
Phone Numbers
Purchase Orders
Tax Rates
Tracking Categories
Transactions
Vendor Credits

Merge Ticketing
Accounts
Attachments
Collections
Comments
Contacts
Roles
Tags
Teams
Tickets
Users

Merge CRM
Accounts
Contacts
Engagement Types
Engagements
Leads
Notes
Opportunities
Stages
Tasks
Users

Merge Marketing Automation
Actions
Automations
Campaigns
Contacts
Emails
Events
Lists
Messages
Templates
Users

Merge File Storage
Drives
Files
Folders
Groups
Users

© Merge 2023
Terms of Use
Privacy Policy