Authorize a social account so Nylon — and your application — can publish to it.
A connection is one social profile that your organization has authorized Nylon to act on. Everything the API can do for a profile depends on one existing, so this is the first thing to do in a new organization.Connections belong to the organization, not to the person who created them. A teammate who joins later sees every connection you have made, and a connection survives you leaving.
Open the Connections page
Select Connections in the sidebar. Every profile your organization has connected is listed here, with the network it belongs to, which OAuth app it was connected through, its status and when it was connected.
Connected profiles, with search, a network filter and a per-row menu.
Until anything is connected you get an empty state instead, offering the two ways to connect.
The two ways to connect
What it means
When to use it
Nylon-managed OAuth
The connection runs through Nylon’s own reviewed platform apps. Nothing to register, no review queue, token refresh handled for you.
Almost always. This is the default.
Your OAuth (BYOK)
The connection runs through platform apps you registered yourself. Your users see your brand on the consent screen, and the quota is yours.
When branding, rate quota or compliance requires it. See What is BYOK?
Both produce the same kind of connection and the same API surface. The OAuth app column on the Connections page shows which one a profile was connected through — Nylon or Your app.
Connect a profile
1
Open the connection panel
From the empty state, select Nylon-managed OAuth. Once you have at least one connection, use the Add connection button in the top right instead.
2
Choose a network
A panel opens from the right listing every network Nylon integrates with.
The Add a connection panel, listing every network Nylon integrates with.
A network shown greyed out with Coming soon has no connection flow yet. One marked Not configured has a flow, but no credentials are available for it — either Nylon’s managed app is not set up in this environment, or the provider needs a BYOK entry you have not added.
3
Authorize with the provider
Nylon sends you to the network’s own login and permission screen. Sign in there and approve everything it asks for — a partial approval usually means Nylon finds no profiles it can use.Three networks do not use a redirect at all, and open a form instead. See Bluesky, Mastodon and DEV.to. Telegram opens no screen anywhere — you add a bot to a chat and send it a command. See Telegram and Slack.
4
Choose what to add
Some networks return several things you could connect. Facebook and Instagram ask which Pages or accounts to add; Google Business asks which locations; Slack asks which channel. See Facebook and Instagram and Google Business.
When it finishes, a banner confirms the result and the profile appears in Connected profiles with its network badge, handle, OAuth app, status and connection date.
Finding a profile
The list pages at 20 profiles. Narrow it with the Search profiles box, which matches on name and handle, or with the All networks filter. Both are applied by the server, so they search everything you have connected rather than the page on screen.
What each row can do
Select the ⋯ button at the end of a row:
View profile — open the profile on the network itself. Disabled when Nylon has no public URL for it.
Disconnect — remove the connection and destroy its stored credentials. See Disconnect an account.
Connecting accounts from your own product
If your users connect their own accounts, you do not want them in the Nylon dashboard. Generate a hosted connection URL from the API and send them to that instead — it runs the same flow and returns them to a URL you choose.
Connecting an account from your own app
The endpoint, its parameters and the redirect contract.
Related
Supported networks
What can be connected and what can be published today.
Connection statuses
Active, Reconnect and Paused — billing, and what each one means.
⌘I
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Nylon API Docs","colors":{"primary":"#357adf","light":"#359bdf","dark":"#357adf"},"logo":{"light":"https://mintcdn.com/nylon/8sDWPpZI53wlGMBT/images/nylon-logo.svg?fit=max\u0026auto=format\u0026n=8sDWPpZI53wlGMBT\u0026q=85\u0026s=1eb1edf70a217092111a28527249906b","dark":"https://mintcdn.com/nylon/8sDWPpZI53wlGMBT/images/nylon-logo-dark.svg?fit=max\u0026auto=format\u0026n=8sDWPpZI53wlGMBT\u0026q=85\u0026s=61bb5cbe6da73c3a5edaaf4d26314b54","href":"https://app.nylon.dev/"},"favicon":"https://mintcdn.com/nylon/8sDWPpZI53wlGMBT/images/favicon.svg?fit=max\u0026auto=format\u0026n=8sDWPpZI53wlGMBT\u0026q=85\u0026s=6129a297664c479adc04e86d342d60bf","api":{"openapi":{"source":"openapi.yaml","directory":"api-reference"},"params":{"expanded":"all"},"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["curl","javascript","python","php","ruby"],"prefill":true,"autogenerate":true},"url":"full"},"navbar":{"links":[{"href":"https://app.nylon.dev/connections","label":"Connections"},{"href":"https://app.nylon.dev/api","label":"API keys"}]},"icons":{"library":"lucide"},"contextual":{"options":["chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nylon","hasAudioNarration":false,"actualSubdomain":"nylon","customDomains":["docs.nylon.dev"],"gitSource":{"type":"github","owner":"ocoya","repo":"ocoya","deployBranch":"main","contentDirectory":"apps/nylon-web/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ac41b48ccd3b85aecd8c4bc","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Help center","count":33},{"language":"default","tag":"API reference","count":32},{"language":"default","tag":"Endpoints","count":31},{"language":"default","tag":"Documentation","count":12},{"language":"default","tag":"Connections","count":12},{"language":"default","tag":"Webhooks","count":11},{"language":"default","tag":"Get started","count":10},{"language":"default","tag":"Posts","count":7},{"language":"default","tag":"Guides","count":5},{"language":"default","tag":"Inbox","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--nylon-publishing: #357adf;--nylon-publishing-soft: #eaf2fc;--nylon-inbox: #059669;--nylon-inbox-soft: #e7f6f0;--nylon-analytics: #ea580c;--nylon-analytics-soft: #fdefe6;--nylon-border: #e5e5e5;--nylon-muted: #737373}.dark{--nylon-publishing-soft: rgba(53, 122, 223, 0.14);--nylon-inbox-soft: rgba(5, 150, 105, 0.14);--nylon-analytics-soft: rgba(234, 88, 12, 0.14);--nylon-border: #262626;--nylon-muted: #a3a3a3}[data-pillar=\"publishing\"]{--pillar: var(--nylon-publishing);--pillar-soft: var(--nylon-publishing-soft)}[data-pillar=\"inbox\"]{--pillar: var(--nylon-inbox);--pillar-soft: var(--nylon-inbox-soft)}[data-pillar=\"analytics\"]{--pillar: var(--nylon-analytics);--pillar-soft: var(--nylon-analytics-soft)}.pillar-hero{display:flex;gap:1rem;align-items:flex-start;padding:1.25rem;margin:0 0 1.75rem;border:1px solid var(--nylon-border);border-left:3px solid var(--pillar);border-radius:12px;background:linear-gradient(90deg, var(--pillar-soft), transparent 70%)}.pillar-hero__mark{display:grid;place-items:center;flex:0 0 auto;width:2.25rem;height:2.25rem;border-radius:9px;background:var(--pillar-soft);color:var(--pillar)}.pillar-hero__mark svg{width:1.125rem;height:1.125rem}.pillar-hero__body{min-width:0}.pillar-hero__eyebrow{display:block;margin:0 0 0.15rem;font-size:0.75rem;font-weight:600;letter-spacing:0.06em;text-transform:uppercase;color:var(--pillar)}.pillar-hero__body p{margin:0;color:var(--nylon-muted);font-size:0.9375rem;line-height:1.55}.pillar-status{display:inline-flex;align-items:center;gap:0.4rem;margin-top:0.6rem;padding:0.15rem 0.55rem;border-radius:999px;font-size:0.75rem;font-weight:500;border:1px solid currentColor}.pillar-status::before{content:'';width:0.4rem;height:0.4rem;border-radius:999px;background:currentColor}.pillar-status--live{color:#047857}.pillar-status--partial{color:#047857}.pillar-status--soon{color:#b45309}#sidebar a[href^=\"/publishing\"] svg,#sidebar a[href*=\"/publishing\"] svg{color:var(--nylon-publishing)}#sidebar a[href^=\"/inbox\"] svg,#sidebar a[href*=\"/inbox\"] svg{color:var(--nylon-inbox)}#sidebar a[href^=\"/analytics\"] svg,#sidebar a[href*=\"/analytics\"] svg{color:var(--nylon-analytics)}#navbar a[href=\"https://app.nylon.dev/\"] img,[data-component-part=\"navbar-logo\"] img{height:18px!important;max-height:18px!important;width:auto!important;max-width:132px!important;object-fit:contain}#navbar a[href=\"https://app.nylon.dev/connections\"],#navbar a[href=\"https://app.nylon.dev/api\"],[data-component-part=\"navbar-link\"][href=\"https://app.nylon.dev/connections\"],[data-component-part=\"navbar-link\"][href=\"https://app.nylon.dev/api\"]{color:#52525b;font-weight:500;text-decoration:none}#navbar a[href=\"https://app.nylon.dev/connections\"]:hover,#navbar a[href=\"https://app.nylon.dev/connections\"]:focus,#navbar a[href=\"https://app.nylon.dev/api\"]:hover,#navbar a[href=\"https://app.nylon.dev/api\"]:focus,[data-component-part=\"navbar-link\"][href=\"https://app.nylon.dev/connections\"]:hover,[data-component-part=\"navbar-link\"][href=\"https://app.nylon.dev/connections\"]:focus,[data-component-part=\"navbar-link\"][href=\"https://app.nylon.dev/api\"]:hover,[data-component-part=\"navbar-link\"][href=\"https://app.nylon.dev/api\"]:focus{color:#27272a}"}],"page":{"pagePath":"help/connect-an-account","slug":"/help/connect-an-account","pageMetadata":{"title":"Connect an account","description":"Authorize a social account so Nylon — and your application — can publish to it.","icon":"plug","href":"/help/connect-an-account"},"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: \"Authorize a social account so Nylon — and your application — can publish to it.\"\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={a:`a`,em:`em`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,Columns,Frame,Heading,OptimizedImage,Step,Steps,Table}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`A connection is one social profile that your organization has authorized Nylon to act on. Everything the API can do for a profile depends on one existing, so this is the first thing to do in a new organization.`}),`\n`,_jsxs(_components.p,{children:[`Connections belong to the `,_jsx(_components.strong,{children:`organization`}),`, not to the person who created them. A teammate who joins later sees every connection you have made, and a connection survives you leaving.`]}),`\n`,_jsx(Heading,{level:`2`,id:`open-the-connections-page`,children:`Open the Connections page`}),`\n`,_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Connections`}),` in the sidebar. Every profile your organization has connected is listed here, with the network it belongs to, which OAuth app it was connected through, its status and when it was connected.`]}),`\n`,_jsx(Frame,{caption:`Connected profiles, with search, a network filter and a per-row menu.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-list.png?fit=max\u0026auto=format\u0026n=1o7WQUbeKU2Ntf4c\u0026q=85\u0026s=4a154625af39f9a2a802fe2f86adc53e`,alt:`Nylon Connections page showing a table of connected profiles with columns for Profile, OAuth app, Status and Connected, plus a search box and an All networks filter`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/screenshots/connections-list.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-list.png?w=280\u0026fit=max\u0026auto=format\u0026n=1o7WQUbeKU2Ntf4c\u0026q=85\u0026s=9381b0a70464f2c3e94bd60b2619aa40 280w, https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-list.png?w=560\u0026fit=max\u0026auto=format\u0026n=1o7WQUbeKU2Ntf4c\u0026q=85\u0026s=1baf649e0f4edf2b0a59155aae537963 560w, https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-list.png?w=840\u0026fit=max\u0026auto=format\u0026n=1o7WQUbeKU2Ntf4c\u0026q=85\u0026s=791da8a1f61b5a39aee91d02d323d959 840w, https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-list.png?w=1100\u0026fit=max\u0026auto=format\u0026n=1o7WQUbeKU2Ntf4c\u0026q=85\u0026s=28fda41a5e11dc28c6996aa013b0d47e 1100w, https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-list.png?w=1650\u0026fit=max\u0026auto=format\u0026n=1o7WQUbeKU2Ntf4c\u0026q=85\u0026s=38a9e95e33daeb52a69ef615a27059e2 1650w, https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-list.png?w=2500\u0026fit=max\u0026auto=format\u0026n=1o7WQUbeKU2Ntf4c\u0026q=85\u0026s=245a0ddcde086449bcf323cfbee15ff1 2500w`})}),`\n`,_jsx(_components.p,{children:`Until anything is connected you get an empty state instead, offering the two ways to connect.`}),`\n`,_jsx(Heading,{level:`2`,id:`the-two-ways-to-connect`,children:`The two ways to connect`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{children:`What it means`}),_jsx(_components.th,{children:`When to use it`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Nylon-managed OAuth`})}),_jsx(_components.td,{children:`The connection runs through Nylon’s own reviewed platform apps. Nothing to register, no review queue, token refresh handled for you.`}),_jsx(_components.td,{children:`Almost always. This is the default.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Your OAuth (BYOK)`})}),_jsx(_components.td,{children:`The connection runs through platform apps you registered yourself. Your users see your brand on the consent screen, and the quota is yours.`}),_jsxs(_components.td,{children:[`When branding, rate quota or compliance requires it. See `,_jsx(_components.a,{href:`/help/what-is-byok`,children:`What is BYOK?`})]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Both produce the same kind of connection and the same API surface. The `,_jsx(_components.strong,{children:`OAuth app`}),` column on the Connections page shows which one a profile was connected through — `,_jsx(_components.em,{children:`Nylon`}),` or `,_jsx(_components.em,{children:`Your app`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`connect-a-profile`,children:`Connect a profile`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the connection panel`,children:_jsxs(_components.p,{children:[`From the empty state, select `,_jsx(_components.strong,{children:`Nylon-managed OAuth`}),`. Once you have at least one connection, use the `,_jsx(_components.strong,{children:`Add connection`}),` button in the top right instead.`]})}),_jsxs(Step,{title:`Choose a network`,children:[_jsx(_components.p,{children:`A panel opens from the right listing every network Nylon integrates with.`}),_jsx(Frame,{caption:`The Add a connection panel, listing every network Nylon integrates with.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-drawer.png?fit=max\u0026auto=format\u0026n=1o7WQUbeKU2Ntf4c\u0026q=85\u0026s=8d57a232dda25f496312356733c07d2a`,alt:`Add a connection panel listing networks, each with a short description and an arrow to continue`,\"data-og-width\":`864`,width:`864`,\"data-og-height\":`2800`,height:`2800`,\"data-path\":`images/screenshots/connections-drawer.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-drawer.png?w=280\u0026fit=max\u0026auto=format\u0026n=1o7WQUbeKU2Ntf4c\u0026q=85\u0026s=b4327f1e939bafca7d0adc1ed3eaf396 280w, https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-drawer.png?w=560\u0026fit=max\u0026auto=format\u0026n=1o7WQUbeKU2Ntf4c\u0026q=85\u0026s=0f52bd2189fd9784fc3758d3892ea3b0 560w, https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-drawer.png?w=840\u0026fit=max\u0026auto=format\u0026n=1o7WQUbeKU2Ntf4c\u0026q=85\u0026s=5b1d23c0cc4a3191711c1a800149f029 840w, https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-drawer.png?w=1100\u0026fit=max\u0026auto=format\u0026n=1o7WQUbeKU2Ntf4c\u0026q=85\u0026s=1da3499b6683750486ffbe4a7fc67db4 1100w, https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-drawer.png?w=1650\u0026fit=max\u0026auto=format\u0026n=1o7WQUbeKU2Ntf4c\u0026q=85\u0026s=bb3ae4bdd90eda1e29363686d00be869 1650w, https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-drawer.png?w=2500\u0026fit=max\u0026auto=format\u0026n=1o7WQUbeKU2Ntf4c\u0026q=85\u0026s=4dbf7b8915c527ec5efa4926873b3407 2500w`})}),_jsxs(_components.p,{children:[`A network shown greyed out with `,_jsx(_components.strong,{children:`Coming soon`}),` has no connection flow yet. One marked `,_jsx(_components.strong,{children:`Not configured`}),` has a flow, but no credentials are available for it — either Nylon’s managed app is not set up in this environment, or the provider needs a `,_jsx(_components.a,{href:`/help/configure-byok`,children:`BYOK entry`}),` you have not added.`]})]}),_jsxs(Step,{title:`Authorize with the provider`,children:[_jsx(_components.p,{children:`Nylon sends you to the network’s own login and permission screen. Sign in there and approve everything it asks for — a partial approval usually means Nylon finds no profiles it can use.`}),_jsxs(_components.p,{children:[`Three networks do not use a redirect at all, and open a form instead. See `,_jsx(_components.a,{href:`/help/connect-bluesky-mastodon-and-devto`,children:`Bluesky, Mastodon and DEV.to`}),`. Telegram opens no screen anywhere — you add a bot to a chat and send it a command. See `,_jsx(_components.a,{href:`/help/connect-telegram-and-slack`,children:`Telegram and Slack`}),`.`]})]}),_jsx(Step,{title:`Choose what to add`,children:_jsxs(_components.p,{children:[`Some networks return several things you could connect. Facebook and Instagram ask which Pages or accounts to add; Google Business asks which locations; Slack asks which channel. See `,_jsx(_components.a,{href:`/help/connect-facebook-and-instagram`,children:`Facebook and Instagram`}),` and `,_jsx(_components.a,{href:`/help/connect-google-business`,children:`Google Business`}),`.`]})})]}),`\n`,_jsxs(_components.p,{children:[`When it finishes, a banner confirms the result and the profile appears in `,_jsx(_components.strong,{children:`Connected profiles`}),` with its network badge, handle, OAuth app, status and connection date.`]}),`\n`,_jsx(Heading,{level:`2`,id:`finding-a-profile`,children:`Finding a profile`}),`\n`,_jsxs(_components.p,{children:[`The list pages at 20 profiles. Narrow it with the `,_jsx(_components.strong,{children:`Search profiles`}),` box, which matches on name and handle, or with the `,_jsx(_components.strong,{children:`All networks`}),` filter. Both are applied by the server, so they search everything you have connected rather than the page on screen.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-each-row-can-do`,children:`What each row can do`}),`\n`,_jsxs(_components.p,{children:[`Select the `,_jsx(_components.strong,{children:`⋯`}),` button at the end of a row:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`View profile`}),` — open the profile on the network itself. Disabled when Nylon has no public URL for it.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Reconnect`}),` — run the authorization again. See `,_jsx(_components.a,{href:`/help/reconnect-an-account`,children:`Reconnect an account`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Disconnect`}),` — remove the connection and destroy its stored credentials. See `,_jsx(_components.a,{href:`/help/disconnect-an-account`,children:`Disconnect an account`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`connecting-accounts-from-your-own-product`,children:`Connecting accounts from your own product`}),`\n`,_jsx(_components.p,{children:`If your users connect their own accounts, you do not want them in the Nylon dashboard. Generate a hosted connection URL from the API and send them to that instead — it runs the same flow and returns them to a URL you choose.`}),`\n`,_jsx(Card,{title:`Connecting an account from your own app`,icon:`square-terminal`,href:`/connections`,children:_jsx(_components.p,{children:`The endpoint, its parameters and the redirect contract.`})}),`\n`,_jsx(Heading,{level:`2`,id:`related`,children:`Related`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Supported networks`,icon:`globe`,href:`/help/supported-networks`,children:_jsx(_components.p,{children:`What can be connected and what can be published today.`})}),_jsx(Card,{title:`Connection statuses`,icon:`circle-check`,href:`/help/connection-statuses`,children:_jsx(_components.p,{children:`Active, Reconnect and Paused — billing, and what each one means.`})})]})]})}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":{"config":{},"pageMetadata":{"title":"Connect an account","description":"Authorize a social account so Nylon — and your application — can publish to it.","icon":"plug","href":"/help/connect-an-account"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Open the Connections page","slug":"open-the-connections-page","depth":2,"children":[]},{"title":"The two ways to connect","slug":"the-two-ways-to-connect","depth":2,"children":[]},{"title":"Connect a profile","slug":"connect-a-profile","depth":2,"children":[]},{"title":"Finding a profile","slug":"finding-a-profile","depth":2,"children":[]},{"title":"What each row can do","slug":"what-each-row-can-do","depth":2,"children":[]},{"title":"Connecting accounts from your own product","slug":"connecting-accounts-from-your-own-product","depth":2,"children":[]},{"title":"Related","slug":"related","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"nylon","siteName":"Nylon API Docs","title":"Connect an account - Nylon API Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-28T13:46:05.744Z","originalFileLocation":"help/connect-an-account.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=\"system\"}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=\"Authorize a social account so Nylon — and your application — can publish to it.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Nylon API Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/nylon/qBZVvcq9uKPk9NJK/_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/nylon/qBZVvcq9uKPk9NJK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/nylon/qBZVvcq9uKPk9NJK/_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/nylon/qBZVvcq9uKPk9NJK/_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/nylon/qBZVvcq9uKPk9NJK/_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/nylon/qBZVvcq9uKPk9NJK/_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/nylon/qBZVvcq9uKPk9NJK/_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/nylon/qBZVvcq9uKPk9NJK/_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/nylon/qBZVvcq9uKPk9NJK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect an account - Nylon API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Authorize a social account so Nylon — and your application — can publish to it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Nylon API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.nylon.dev/help/connect-an-account\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://nylon.mintlify.site/_mintlify/api/og/v2?division=Connections\u0026amp;title=Connect+an+account\u0026amp;description=Authorize+a+social+account+so+Nylon+%E2%80%94+and+your+application+%E2%80%94+can+publish+to+it.\u0026amp;theme=b05593bd5939955c58560eb1\u0026amp;signature=0baa129792dd4a69c479b868d877a217091cb6f56b86c8d570cf1646969f4d80\">\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=\"Connect an account - Nylon API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Authorize a social account so Nylon — and your application — can publish to it.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nylon.mintlify.site/_mintlify/api/og/v2?division=Connections\u0026amp;title=Connect+an+account\u0026amp;description=Authorize+a+social+account+so+Nylon+%E2%80%94+and+your+application+%E2%80%94+can+publish+to+it.\u0026amp;theme=b05593bd5939955c58560eb1\u0026amp;signature=0baa129792dd4a69c479b868d877a217091cb6f56b86c8d570cf1646969f4d80\">\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/nylon/qBZVvcq9uKPk9NJK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Nylon API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#357adf\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.nylon.dev/help/connect-an-account\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/help/connect-an-account.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.nylon.dev/#organization\",\"name\":\"Nylon API Docs\",\"url\":\"https://docs.nylon.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nylon/8sDWPpZI53wlGMBT/images/nylon-logo.svg?fit=max\u0026auto=format\u0026n=8sDWPpZI53wlGMBT\u0026q=85\u0026s=1eb1edf70a217092111a28527249906b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.nylon.dev#website\",\"name\":\"Nylon API Docs\",\"url\":\"https://docs.nylon.dev\",\"publisher\":{\"@id\":\"https://docs.nylon.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.nylon.dev/help/connect-an-account#webpage\",\"url\":\"https://docs.nylon.dev/help/connect-an-account\",\"name\":\"Connect an account\",\"description\":\"Authorize a social account so Nylon — and your application — can publish to it.\",\"dateModified\":\"2026-09-28T13:46:05.744Z\",\"isPartOf\":{\"@id\":\"https://docs.nylon.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.nylon.dev/help/connect-an-account#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.nylon.dev/help/connect-an-account#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Nylon API Docs\",\"item\":\"https://docs.nylon.dev\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect an account\",\"item\":\"https://docs.nylon.dev/help/connect-an-account\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.nylon.dev/help/connect-an-account#article\",\"headline\":\"Connect an account\",\"name\":\"Connect an account\",\"description\":\"Authorize a social account so Nylon — and your application — can publish to it.\",\"url\":\"https://docs.nylon.dev/help/connect-an-account\",\"mainEntityOfPage\":{\"@id\":\"https://docs.nylon.dev/help/connect-an-account#webpage\"},\"dateModified\":\"2026-09-28T13:46:05.744Z\",\"publisher\":{\"@id\":\"https://docs.nylon.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.nylon.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Nylon API Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Nylon API Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/help/connect-an-account.md","siteName":"Nylon API Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/welcome"}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference"}]},{"tab":"MCP server","pages":[{"title":"MCP server","href":"/mcp/get-started"}]},{"tab":"Help center","groups":[{"group":"Get started","icon":"rocket","pages":[{"title":"Nylon help center","icon":"life-buoy","href":"/help"},{"title":"What is Nylon?","icon":"sparkles","href":"/help/what-is-nylon"},{"title":"Create your account","icon":"user-plus","href":"/help/create-your-account"},{"title":"Connect your first account","description":"From a new Nylon organization to a connected social profile and a published post.","icon":"rocket","href":"/help/connect-your-first-account"}]},{"group":"Connections","icon":"plug","pages":[{"title":"Connect an account","icon":"plug","href":"/help/connect-an-account"},{"title":"Supported networks","description":"Which networks Nylon publishes to, which you can connect from the dashboard today, and how the unusual ones behave.","icon":"globe","href":"/help/supported-networks"},{"title":"Connection statuses","icon":"circle-check","href":"/help/connection-statuses"},{"title":"Reconnect an account","icon":"refresh-cw","href":"/help/reconnect-an-account"},{"title":"Disconnect an account","icon":"unplug","href":"/help/disconnect-an-account"},{"group":"Networks that connect differently","icon":"git-fork","pages":[{"title":"Connect Facebook and Instagram","icon":"facebook","href":"/help/connect-facebook-and-instagram"},{"title":"Connect Google Business","icon":"map-pin","href":"/help/connect-google-business"},{"title":"Connect Telegram and Slack","icon":"message-square","href":"/help/connect-telegram-and-slack"},{"title":"Connect Bluesky, Mastodon and DEV.to","icon":"key-round","href":"/help/connect-bluesky-mastodon-and-devto"}]}]},{"group":"API keys","icon":"key","pages":[{"title":"API keys","icon":"key","href":"/help/api-keys"},{"title":"Keep keys secure","icon":"shield","href":"/help/keep-keys-secure"}]},{"group":"Webhooks","icon":"webhook","pages":[{"title":"Add a webhook endpoint","icon":"webhook","href":"/help/add-a-webhook-endpoint"},{"title":"Webhook events","icon":"list","href":"/help/webhook-events"},{"title":"Webhook deliveries and failures","icon":"repeat","href":"/help/webhook-deliveries-and-failures"}]},{"group":"Request logs","icon":"activity","pages":[{"title":"Request logs","icon":"activity","href":"/help/request-logs"},{"title":"Debug a failed request","icon":"bug","href":"/help/debug-a-failed-request"}]},{"group":"Sandbox","icon":"flask-conical","pages":[{"title":"Publish a test post","icon":"flask-conical","href":"/help/test-a-post"}]},{"group":"Bring your own keys","icon":"shield","pages":[{"title":"What is BYOK?","icon":"shield","href":"/help/what-is-byok"},{"title":"Configure BYOK","icon":"settings","href":"/help/configure-byok"}]},{"group":"Your team","icon":"users","pages":[{"title":"Invite your team","icon":"users","href":"/help/invite-your-team"},{"title":"Roles and permissions","icon":"shield-check","href":"/help/roles-and-permissions"}]},{"group":"Billing","icon":"credit-card","pages":[{"title":"How pricing works","icon":"credit-card","href":"/help/how-pricing-works"},{"title":"Manage billing and invoices","icon":"receipt","href":"/help/manage-billing-and-invoices"},{"title":"Accounts paused for billing","icon":"pause","href":"/help/paused-accounts"}]},{"group":"Account and data","icon":"user","pages":[{"title":"Your account and organization","icon":"user","href":"/help/your-account"},{"title":"What Nylon stores","icon":"database","href":"/help/data-and-security"}]},{"group":"Troubleshooting","icon":"life-buoy","pages":[{"title":"An account says Reconnect","icon":"triangle-alert","href":"/help/account-needs-attention"},{"title":"A post didn't publish","icon":"send","href":"/help/post-didnt-publish"},{"title":"A webhook never arrived","icon":"webhook","href":"/help/webhook-not-arriving"}]}]}]},"basePath":"","title":"Connect an account - Nylon API Docs","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D2acuaLg.js","DynamicMarkdown-Co5nikxh.js","zoom-image-lightbox-BbK2OBGL.js","lightbox-handle-r17bVUz3.js"]}