POST
/link-token
Creates a link token to be used when linking a new end user.
Header Parameters
Authorization
StringRequired
Token-based authentication with required prefix "Bearer"
Body Parameters
end_user_email_address
StringRequired
Unique ID for your end user.
end_user_organization_name
StringRequired
Your end user's organization.
end_user_origin_id
StringRequired
Your end user's email address.
categories
ArrayRequired
The integration categories to show in Merge Link.
integration
StringOptional
The slug of a specific pre-selected integration for this linking flow token. For examples of slugs, see https://www.merge.dev/docs/basics/integration-metadata/.
link_expiry_mins
IntegerRequired
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_url
BooleanOptional
Whether to generate a Magic Link URL. Defaults to false. For more information on Magic Link, see https://merge.dev/blog/product/integrations,-fast.-say-hello-to-magic-link/.
Response
JSON
{"link_token": "necdP7FtdASl1fQwm62be2_dM4wBG8_GactqoUV0","integration_name": "Lever","magic_link_url": "https://link.merge.dev/asdfjkl12345jsndfgi2i83n"}