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.
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 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.
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.
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. 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.
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.
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.
