> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nylon.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect an account

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

<Frame caption="Connected profiles, with search, a network filter and a per-row menu.">
  <img src="https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-list.png?fit=max&auto=format&n=1o7WQUbeKU2Ntf4c&q=85&s=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" width="2880" height="1800" data-path="images/screenshots/connections-list.png" />
</Frame>

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?](/help/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

<Steps>
  <Step title="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.
  </Step>

  <Step title="Choose a network">
    A panel opens from the right listing every network Nylon integrates with.

    <Frame caption="The Add a connection panel, listing every network Nylon integrates with.">
      <img src="https://mintcdn.com/nylon/1o7WQUbeKU2Ntf4c/images/screenshots/connections-drawer.png?fit=max&auto=format&n=1o7WQUbeKU2Ntf4c&q=85&s=8d57a232dda25f496312356733c07d2a" alt="Add a connection panel listing networks, each with a short description and an arrow to continue, and some marked Coming soon" width="864" height="2800" data-path="images/screenshots/connections-drawer.png" />
    </Frame>

    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](/help/configure-byok) you have not added.
  </Step>

  <Step title="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](/help/connect-bluesky-mastodon-and-devto).
  </Step>

  <Step title="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](/help/connect-facebook-and-instagram) and [Google Business](/help/connect-google-business).
  </Step>
</Steps>

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.
* **Reconnect** — run the authorization again. See [Reconnect an account](/help/reconnect-an-account).
* **Disconnect** — remove the connection and destroy its stored credentials. See [Disconnect an account](/help/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.

<Card title="Connecting an account from your own app" icon="square-terminal" href="/connections">
  The endpoint, its parameters and the redirect contract.
</Card>

## Related

<Columns cols={2}>
  <Card title="Supported networks" icon="globe" href="/help/supported-networks">
    What can be connected and what can be published today.
  </Card>

  <Card title="Connection statuses" icon="circle-check" href="/help/connection-statuses">
    Active, Reconnect and Paused — billing, and what each one means.
  </Card>
</Columns>
