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

# Quickstart

> Connect your first integration in under 10 minutes.

This guide walks through connecting a pre-built integration from the connector catalog. The steps are the same for most connector types—only the authentication method varies.

## Before you begin

* Admin or Member role in your workspace
* Credentials for the tool you want to connect (API key, OAuth app client ID and secret, or service account)

## Steps

<Steps>
  <Step title="Find your integration">
    Go to **Integrations → Catalog** and search for or browse to the tool you want to connect. Each connector card shows the authentication method and sync capabilities.
  </Step>

  <Step title="Authenticate">
    Click **Connect** on the connector. Depending on the authentication method:

    * **API key** — Paste the key into the provided field.
    * **OAuth 2.0** — Click **Authorize** to be redirected to the tool's authorization page. Sign in and grant access, then you'll be returned automatically.
    * **Service account** — Upload the credentials file (usually a JSON key file) and enter any required fields.

    See [Authentication methods](/integrations/authentication) for details on each approach.
  </Step>

  <Step title="Configure field mapping">
    Map fields from the connected tool to your workspace's data model. Default mappings are pre-filled for common fields—review them and adjust as needed. Required fields are marked with an asterisk.
  </Step>

  <Step title="Test the connection">
    Click **Test connection** to trigger a sample sync. The test pulls a small number of records and displays them for review. If the test fails, an error message explains the cause.
  </Step>
</Steps>

<Note>
  Some connectors require the platform's outbound IP addresses to be allowlisted on your end. Check the connector's setup notes for IP requirements before testing.
</Note>

## Next steps

* Review [authentication methods](/integrations/authentication) to understand when to rotate credentials.
* Explore [connectors](/integrations/connectors) for category-specific setup details.
* Set up [webhooks](/integrations/webhooks/configure) if you need event-driven automation.