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

# Quickstart

> Create an API key and make your first Instantly API v2 request.

Make an authenticated API request in a few minutes.

## Prerequisites

Before you begin, you need:

* Access to an Instantly workspace.
* A tool that can send HTTP requests. This guide uses cURL.

<Steps>
  <Step title="Create an API key">
    Open [**Settings > Integrations > API Keys**](https://app.instantly.ai/app/settings/integrations) and create an API v2 key.

    Select the scopes your integration needs. Copy the key when Instantly displays it because you cannot view it again.
  </Step>

  <Step title="Send your first request">
    List up to five email accounts in your workspace:

    ```bash theme={null}
    curl --request GET \
      --url "https://api.instantly.ai/api/v2/accounts?limit=5" \
      --header "Authorization: Bearer YOUR_API_KEY"
    ```

    Replace `YOUR_API_KEY` with the key you created. A successful request returns a JSON response containing the accounts your key can access.
  </Step>

  <Step title="Handle errors">
    Check the HTTP status code before processing the response:

    * `401` means the API key is missing or invalid.
    * `403` means the API key does not have the required scope.
    * `429` means the workspace exceeded an API rate limit.
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Authorization" icon="key" href="/getting-started/authorization">
    Learn how bearer authentication works.
  </Card>

  <Card title="Rate limits" icon="gauge" href="/getting-started/rate-limit">
    Keep your integration within workspace limits.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/introduction">
    Browse available endpoints and schemas.
  </Card>

  <Card title="Integration guides" icon="book-open" href="/guides/oauth-connection-flow">
    Follow detailed guides for OAuth, webhooks, and workspace groups.
  </Card>
</CardGroup>