Quickstart - Instantly API Docs

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.

Create an API key

Open Settings > Integrations > API Keys 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.

Send your first request

List up to five email accounts in your workspace:

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.

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.

Next steps

Authorization

Learn how bearer authentication works.

Rate limits

Keep your integration within workspace limits.

API reference

Browse available endpoints and schemas.

Integration guides

Follow detailed guides for OAuth, webhooks, and workspace groups.

⌘I

​Prerequisites

​Next steps