Creates an OAuth link for a user to connect an account. When the user completes the flow, Markifact stores the connection in your team workspace.By default, the resulting connection is shared with the workspace, so other team members can see and use it. Set is_private to true if the connection should only be visible and usable by the user who created the API key.
Endpoint
POST /v1/connections/auth-link
Request Body
Field
Type
Required
Description
connection_type
string
Yes
Supported connection type, such as ga4, gads, or meta_ads.
redirect_url
string
No
HTTPS URL to redirect the user to after the OAuth callback.
external_id
string
No
Your ID for the customer, store, workspace, or account. Max 255 characters.
is_private
boolean
No
Whether the created connection should be private to the API-key user. Defaults to false, meaning shared with the workspace so other team members can see and use it.
Best practices for external_id
external_id is how you tie a resulting connection back to a record in your own system. It is stored on the created connection and returned unchanged in both the connection responses and the redirect parameters.
Use a stable, unique ID from your system — your customer, workspace, store, or account ID. Avoid values that change over time so lookups stay reliable.
Keep it opaque. Don’t put PII or secrets in it (no emails, names, tokens). It is echoed back in the redirect URL query string, so it can land in browser history, referrer headers, and logs.
Use it to look connections up later with GET /v1/connections?external_id=... or GET /v1/connections/{external_id}?lookup_by=external_id, instead of storing Markifact connection IDs yourself.
Treat lookups as potentially returning multiple connections.external_id is not unique — a customer may reconnect or connect more than one account, so a single external_id can map to several connections.
Set it at creation time. It can only be provided when the link is created; it is not editable afterwards.
Auth link ID. Use this with the auth link status endpoint.
url
string
URL to send the user to.
expires_at
integer
Expiration timestamp in milliseconds.
Auth links expire 24 hours after creation, or as soon as a connection is
successfully created — whichever comes first. Each link can be used to create
one connection; generate a new link if it expires or has already been used.
Redirect URL Parameters
If you provide redirect_url, Markifact redirects the user’s browser back to that URL after the OAuth provider returns to Markifact. The redirect URL must use HTTPS.Markifact preserves any query parameters already on your URL and appends result metadata. Treat this browser redirect as a user-experience handoff, not as your only source of truth. For server-side confirmation, call the auth link status endpoint using the id returned when you created the link.
Success Redirect
When OAuth succeeds, Markifact stores the connection in your workspace, marks the auth link as connected, and redirects with:
Your optional external ID, returned unchanged when provided.
error
A URL-encoded error message suitable for logging or showing a generic retry prompt.
Error redirects do not consume the auth link. The user can retry the same link until it expires.
Existing Query Parameters
Existing query parameters on your redirect_url are preserved. If your URL already contains one of Markifact’s parameter names, Markifact avoids overwriting it by adding a markifact_ prefix.For example, if you create a link with:
Your redirect handler should read markifact_status when present, otherwise read status.
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
connection_type
string
required
Example:
"ga4"
redirect_url
string<uri>
Example:
"https://example.com/oauth/callback"
external_id
string
Maximum string length: 255
Example:
"customer_123"
is_private
boolean
default:false
Whether the created connection should be private to the API-key user. Defaults to false, meaning shared with the workspace so other team members can see and use it.
Response
Auth link created.
id
string
required
url
string<uri>
required
expires_at
integer<int64>
required
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Markifact","colors":{"primary":"#1374FF","light":"#1374FF","dark":"#1374FF"},"logo":{"light":"https://mintcdn.com/markifact/s418riJ1kIvXeqdE/logo/light.png?fit=max\u0026auto=format\u0026n=s418riJ1kIvXeqdE\u0026q=85\u0026s=97a0d799b6dd0f43778a389425cf0213","dark":"https://mintcdn.com/markifact/s418riJ1kIvXeqdE/logo/dark.png?fit=max\u0026auto=format\u0026n=s418riJ1kIvXeqdE\u0026q=85\u0026s=bebd2a4899640adec9102bc2f6dd85ec"},"favicon":"https://mintcdn.com/markifact/Ljk8anYBzOzZ898C/favicon.ico?fit=max\u0026auto=format\u0026n=Ljk8anYBzOzZ898C\u0026q=85\u0026s=2402591c302780d9642e9e5dcf964340","appearance":{"default":"light"},"navbar":{"links":[{"href":"https://www.markifact.com/auth/signin","label":"Log In"}],"primary":{"type":"button","label":"App","href":"https://markifact.com/"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/markifact","twitter":"https://twitter.com/markifactcom","youtube":"https://www.youtube.com/@markifactcom"}},"seo":{"metatags":{"og:site_name":"Markifact","og:image":"/images/og-image.webp","canonical":"https://docs.markifact.com"}},"styling":{"codeblocks":"dark","latex":true},"integrations":{"gtm":{"tagId":"GTM-MDGV4NFS"}},"contextual":{"options":["copy","view"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Contact Support","icon":"heart","href":"https://www.markifact.com/app/contact-us"},{"anchor":"Changelog","icon":"clock","href":"https://www.markifact.com/changelog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"markifact","hasAudioNarration":false,"actualSubdomain":"markifact","customDomains":["docs.markifact.com"],"gitSource":{"type":"github","owner":"ahmed-3li","repo":"markifact-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b0022bae5f390b6d28e2777","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":1261},{"language":"default","tag":"Operations","count":1237},{"language":"default","tag":"Google Tag Manager","count":98},{"language":"default","tag":"Meta Ads","count":98},{"language":"default","tag":"Microsoft Ads","count":98},{"language":"default","tag":"Google Ads","count":70},{"language":"default","tag":"X Ads","count":63},{"language":"default","tag":"Snapchat Ads","count":54},{"language":"default","tag":"DV360","count":53},{"language":"default","tag":"LinkedIn Ads","count":51}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/connections/create-auth-link","slug":"/api-reference/connections/create-auth-link","pageMetadata":{"title":"Create auth link","description":"Create a shareable OAuth link that connects an external account to your Markifact team.","openapi":"POST /v1/connections/auth-link","href":"/api-reference/connections/create-auth-link"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create a shareable OAuth link that connects an external account to your Markifact team.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Creates an OAuth link for a user to connect an account. When the user completes the flow, Markifact stores the connection in your team workspace.`}),`\n`,_jsxs(_components.p,{children:[`By default, the resulting connection is shared with the workspace, so other team members can see and use it. Set `,_jsx(_components.code,{children:`is_private`}),` to `,_jsx(_components.code,{children:`true`}),` if the connection should only be visible and usable by the user who created the API key.`]}),`\n`,_jsx(Heading,{level:`2`,id:`endpoint`,children:`Endpoint`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`POST`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` /v1/connections/auth-link`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`request-body`,children:`Request Body`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`connection_type`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Supported connection type, such as `,_jsx(_components.code,{children:`ga4`}),`, `,_jsx(_components.code,{children:`gads`}),`, or `,_jsx(_components.code,{children:`meta_ads`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`redirect_url`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`HTTPS URL to redirect the user to after the OAuth callback.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`external_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Your ID for the customer, store, workspace, or account. Max 255 characters.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`is_private`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Whether the created connection should be private to the API-key user. Defaults to `,_jsx(_components.code,{children:`false`}),`, meaning shared with the workspace so other team members can see and use it.`]})]})]})]}),`\n`,_jsxs(Heading,{level:`3`,id:`best-practices-for-external_id`,children:[`Best practices for `,_jsx(_components.code,{children:`external_id`})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`external_id`}),` is how you tie a resulting connection back to a record in your own system. It is stored on the created connection and returned unchanged in both the connection responses and the redirect parameters.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Use a stable, unique ID from your system`}),` — your customer, workspace, store, or account ID. Avoid values that change over time so lookups stay reliable.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Keep it opaque. Don’t put PII or secrets in it`}),` (no emails, names, tokens). It is echoed back in the redirect URL query string, so it can land in browser history, referrer headers, and logs.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Use it to look connections up later`}),` with `,_jsx(_components.code,{children:`GET /v1/connections?external_id=...`}),` or `,_jsx(_components.code,{children:`GET /v1/connections/{external_id}?lookup_by=external_id`}),`, instead of storing Markifact connection IDs yourself.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Treat lookups as potentially returning multiple connections.`}),` `,_jsx(_components.code,{children:`external_id`}),` is not unique — a customer may reconnect or connect more than one account, so a single `,_jsx(_components.code,{children:`external_id`}),` can map to several connections.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Set it at creation time.`}),` It can only be provided when the link is created; it is not editable afterwards.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`example-request`,children:`Example Request`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` https://api.markifact.com/v1/connections/auth-link`}),_jsx(_components.span,{style:{color:`#D7BA7D`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#D7BA7D`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#D7BA7D`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"connection_type\": \"ga4\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"redirect_url\": \"https://example.com/oauth/callback\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"external_id\": \"customer_123\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"is_private\": false`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"7b6a5c4d-0000-0000-0000-000000000000\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"https://app.markifact.com/connect?token=...\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"expires_at\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#B5CEA8`,\"--shiki-dark\":`#B5CEA8`},children:`1764086400000`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Auth link ID. Use this with the auth link status endpoint.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`url`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`URL to send the user to.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`expires_at`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Expiration timestamp in milliseconds.`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Auth links expire `,_jsx(_components.strong,{children:`24 hours`}),` after creation, or as soon as a connection is\nsuccessfully created — whichever comes first. Each link can be used to create\none connection; generate a new link if it expires or has already been used.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`redirect-url-parameters`,children:`Redirect URL Parameters`}),`\n`,_jsxs(_components.p,{children:[`If you provide `,_jsx(_components.code,{children:`redirect_url`}),`, Markifact redirects the user’s browser back to that URL after the OAuth provider returns to Markifact. The redirect URL must use HTTPS.`]}),`\n`,_jsxs(_components.p,{children:[`Markifact preserves any query parameters already on your URL and appends result metadata. Treat this browser redirect as a user-experience handoff, not as your only source of truth. For server-side confirmation, call the auth link status endpoint using the `,_jsx(_components.code,{children:`id`}),` returned when you created the link.`]}),`\n`,_jsx(Heading,{level:`3`,id:`success-redirect`,children:`Success Redirect`}),`\n`,_jsx(_components.p,{children:`When OAuth succeeds, Markifact stores the connection in your workspace, marks the auth link as connected, and redirects with:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`status=success`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`connection_type=ga4`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`connection_id=1f2e3d4c-0000-0000-0000-000000000000`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`external_id=customer_123`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`success`}),` when the connection was created.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`connection_type`})}),_jsxs(_components.td,{children:[`The connection type originally requested, such as `,_jsx(_components.code,{children:`ga4`}),` or `,_jsx(_components.code,{children:`gads`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`connection_id`})}),_jsx(_components.td,{children:`The Markifact connection ID created by the completed OAuth flow. Use this with the connections API.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`external_id`})}),_jsx(_components.td,{children:`Your optional external ID, returned unchanged when provided.`})]})]})]}),`\n`,_jsx(_components.p,{children:`Example final redirect:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://example.com/oauth/callback?status=success\u0026connection_type=ga4\u0026connection_id=1f2e3d4c-0000-0000-0000-000000000000\u0026external_id=customer_123`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`error-redirect`,children:`Error Redirect`}),`\n`,_jsx(_components.p,{children:`When OAuth fails, is denied by the user, or cannot be completed, Markifact redirects with:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`status=error`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`connection_type=ga4`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`external_id=customer_123`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`error=Authorization%20failed`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`error`}),` when the connection was not created.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`connection_type`})}),_jsx(_components.td,{children:`The connection type originally requested.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`external_id`})}),_jsx(_components.td,{children:`Your optional external ID, returned unchanged when provided.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`error`})}),_jsx(_components.td,{children:`A URL-encoded error message suitable for logging or showing a generic retry prompt.`})]})]})]}),`\n`,_jsx(_components.p,{children:`Error redirects do not consume the auth link. The user can retry the same link until it expires.`}),`\n`,_jsx(Heading,{level:`3`,id:`existing-query-parameters`,children:`Existing Query Parameters`}),`\n`,_jsxs(_components.p,{children:[`Existing query parameters on your `,_jsx(_components.code,{children:`redirect_url`}),` are preserved. If your URL already contains one of Markifact’s parameter names, Markifact avoids overwriting it by adding a `,_jsx(_components.code,{children:`markifact_`}),` prefix.`]}),`\n`,_jsx(_components.p,{children:`For example, if you create a link with:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://example.com/oauth/callback?status=started\u0026session_id=abc`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`a successful redirect would look like:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://example.com/oauth/callback?status=started\u0026session_id=abc\u0026markifact_status=success\u0026connection_type=ga4\u0026connection_id=1f2e3d4c-0000-0000-0000-000000000000\u0026external_id=customer_123`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`Your redirect handler should read `,_jsx(_components.code,{children:`markifact_status`}),` when present, otherwise read `,_jsx(_components.code,{children:`status`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Create auth link","description":"Create a shareable OAuth link that connects an external account to your Markifact team.","openapi":"POST /v1/connections/auth-link","href":"/api-reference/connections/create-auth-link"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Endpoint","slug":"endpoint","depth":2,"children":[]},{"title":"Request Body","slug":"request-body","depth":2,"children":[{"title":"Best practices for external_id","slug":"best-practices-for-external_id","depth":3,"children":[]}]},{"title":"Example Request","slug":"example-request","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Response Fields","slug":"response-fields","depth":2,"children":[]},{"title":"Redirect URL Parameters","slug":"redirect-url-parameters","depth":2,"children":[{"title":"Success Redirect","slug":"success-redirect","depth":3,"children":[]},{"title":"Error Redirect","slug":"error-redirect","depth":3,"children":[]},{"title":"Existing Query Parameters","slug":"existing-query-parameters","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/markifact/3685bc415eb86d32/chatbase.js"],"openApiReferenceData":{"operation":{"operationId":"createAuthLink","summary":"Create auth link","description":"Create a shareable OAuth link that connects an external account to your Markifact team.","tags":["Connections"],"requestBody":"ef814a0a-4a7d-4d4c-b5ce-70deec9fa5e6","responses":{"200":"837c0d70-1302-4a29-84c4-656e78723fce","400":"88a17211-2e03-4fce-9a97-8cd143876cdb"},"method":"post","type":"path","servers":["f57092d7-b197-440e-9fca-7df546756ae9"],"security":["c8564385-cff3-4bb0-9dde-2883723f4b64"],"path":"/v1/connections/auth-link","baseUrlOptions":["https://api.markifact.com"],"title":"Create auth link","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connection_type":{"type":"string","example":"ga4","isRequired":true,"uniqueKey":"connection_type","typeLabel":"string"},"redirect_url":{"type":"string","format":"uri","example":"https://example.com/oauth/callback","uniqueKey":"redirect_url","typeLabel":"string\u003curi>"},"external_id":{"type":"string","maxLength":255,"example":"customer_123","uniqueKey":"external_id","typeLabel":"string"},"is_private":{"type":"boolean","default":false,"description":"Whether the created connection should be private to the API-key user. Defaults to false, meaning shared with the workspace so other team members can see and use it.","uniqueKey":"is_private","typeLabel":"boolean"}},"required":["connection_type"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"connection_type":"ga4","redirect_url":"https://example.com/oauth/callback","external_id":"customer_123","is_private":false}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"837c0d70-1302-4a29-84c4-656e78723fce":{"description":"Auth link created.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"url","typeLabel":"string\u003curi>"},"expires_at":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"expires_at","typeLabel":"integer\u003cint64>"}},"required":["id","url","expires_at"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","url":"\u003cstring>","expires_at":123}}},"exampleType":"generated"}},"exampleType":"generated"},"88a17211-2e03-4fce-9a97-8cd143876cdb":{"description":"Invalid request.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"oneOf":[{}],"uniqueKey":"detail","typeLabel":"any"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c8564385-cff3-4bb0-9dde-2883723f4b64":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[]}}},"servers":{"f57092d7-b197-440e-9fca-7df546756ae9":{"url":"https://api.markifact.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"markifact","siteName":"Markifact","title":"Create auth link - Markifact","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-25T12:13:51.454Z","originalFileLocation":"api-reference/connections/create-auth-link.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a shareable OAuth link that connects an external account to your Markifact team.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Markifact\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/markifact/rRckqEm4YH35F_Gi/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/markifact/rRckqEm4YH35F_Gi/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/markifact/rRckqEm4YH35F_Gi/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/markifact/rRckqEm4YH35F_Gi/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/markifact/rRckqEm4YH35F_Gi/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/markifact/rRckqEm4YH35F_Gi/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/markifact/rRckqEm4YH35F_Gi/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/markifact/rRckqEm4YH35F_Gi/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/markifact/rRckqEm4YH35F_Gi/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create auth link - Markifact\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a shareable OAuth link that connects an external account to your Markifact team.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Markifact\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.markifact.com/api-reference/connections/create-auth-link\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://markifact.mintlify.site/images/og-image.webp\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create auth link - Markifact\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a shareable OAuth link that connects an external account to your Markifact team.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://markifact.mintlify.site/images/og-image.webp\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/markifact/rRckqEm4YH35F_Gi/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Markifact\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1374FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.markifact.com/api-reference/connections/create-auth-link\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/connections/create-auth-link.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.markifact.com/#organization\",\"name\":\"Markifact\",\"url\":\"https://docs.markifact.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/markifact/s418riJ1kIvXeqdE/logo/light.png?fit=max\u0026auto=format\u0026n=s418riJ1kIvXeqdE\u0026q=85\u0026s=97a0d799b6dd0f43778a389425cf0213\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.markifact.com#website\",\"name\":\"Markifact\",\"url\":\"https://docs.markifact.com\",\"publisher\":{\"@id\":\"https://docs.markifact.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.markifact.com/api-reference/connections/create-auth-link#webpage\",\"url\":\"https://docs.markifact.com/api-reference/connections/create-auth-link\",\"name\":\"Create auth link\",\"description\":\"Create a shareable OAuth link that connects an external account to your Markifact team.\",\"dateModified\":\"2026-05-25T12:13:51.454Z\",\"isPartOf\":{\"@id\":\"https://docs.markifact.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.markifact.com/api-reference/connections/create-auth-link#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.markifact.com/api-reference/connections/create-auth-link#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Connections\",\"item\":\"https://docs.markifact.com/api-reference/connections/list-connections\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create auth link\",\"item\":\"https://docs.markifact.com/api-reference/connections/create-auth-link\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.markifact.com/api-reference/connections/create-auth-link#apireference\",\"headline\":\"Create auth link\",\"name\":\"Create auth link\",\"description\":\"Create a shareable OAuth link that connects an external account to your Markifact team.\",\"url\":\"https://docs.markifact.com/api-reference/connections/create-auth-link\",\"mainEntityOfPage\":{\"@id\":\"https://docs.markifact.com/api-reference/connections/create-auth-link#webpage\"},\"image\":\"https://docs.markifact.com/images/og-image.webp\",\"dateModified\":\"2026-05-25T12:13:51.454Z\",\"publisher\":{\"@id\":\"https://docs.markifact.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.markifact.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Markifact\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Markifact\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/connections/create-auth-link.md","siteName":"Markifact","nav":{"global":{"anchors":[{"anchor":"Contact Support","icon":"heart","href":"https://www.markifact.com/app/contact-us"},{"anchor":"Changelog","icon":"clock","href":"https://www.markifact.com/changelog"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Get Started","icon":"rocket","pages":[{"title":"Getting started","href":"/api-reference/getting-started"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Errors","href":"/api-reference/errors"}]},{"group":"Connections","icon":"plug","pages":[{"title":"List connections","openapi":"GET /v1/connections","href":"/api-reference/connections/list-connections"},{"title":"Get connection","openapi":"GET /v1/connections/{connection_id}","href":"/api-reference/connections/get-connection"},{"title":"List connection types","openapi":"GET /v1/connections/types","href":"/api-reference/connections/list-connection-types"},{"title":"Create connection","description":"Create a connection from credentials you already hold, verified with the provider before anything is stored.","openapi":"POST /v1/connections","href":"/api-reference/connections/create-connection"},{"title":"Create auth link","openapi":"POST /v1/connections/auth-link","href":"/api-reference/connections/create-auth-link"},{"title":"Get auth link status","description":"Check whether an auth link is pending, expired, or connected.","openapi":"GET /v1/connections/auth-links/{auth_link_id}/status","href":"/api-reference/connections/get-auth-link-status"},{"title":"Delete connection","openapi":"DELETE /v1/connections/{connection_id}","href":"/api-reference/connections/delete-connection"}]},{"group":"Credits","icon":"coins","pages":[{"title":"Get credit balance","openapi":"GET /v1/credits","href":"/api-reference/credits/get-balance"},{"title":"List credit logs","openapi":"GET /v1/credits/logs","href":"/api-reference/credits/list-credit-logs"}]},{"group":"Logs","icon":"list-check","pages":[{"title":"List logs","openapi":"GET /v1/logs","href":"/api-reference/logs/list-logs"},{"title":"Get log","openapi":"GET /v1/logs/{log_id}","href":"/api-reference/logs/get-log"}]}]}]},"basePath":"","title":"Create auth link - Markifact","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}