Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 1 | ## How do I connect Instantly with an API key? |
| 2 | |
| 3 | Instantly doesn't support OAuth, so you connect with an Instantly API key. You don't need a client ID, client secret, redirect URL, or OAuth scopes. |
| 4 | |
| 5 | ### Create the API key in Instantly |
| 6 | |
| 7 | 1. Sign in to Instantly and go to **Settings** > **Integrations** > **API Keys**. |
| 8 | |
| 9 |  |
| 10 | 2. Create a new API key and select its scopes (see Scopes below). Use a v2 key; v1 keys no longer work. |
| 11 | |
| 12 |  |
| 13 | 3. Copy the key and store it in a secret manager. |
| 14 | |
| 15 | ### Create the auth config in Composio |
| 16 | |
| 17 | 1. In the Composio dashboard, go to **Auth Configs**, click **Create Auth Config**, and select **Instantly**. |
| 18 | |
| 19 |  |
| 20 | |
| 21 |  |
| 22 | 2. Keep the authentication type as **API Key** and create the auth config. |
| 23 | |
| 24 |  |
| 25 | 3. Click **Connect Account**, paste your Instantly API key, and confirm the account shows as **Active**. |
| 26 | |
| 27 | See [Custom auth configs](/docs/auth-configuration/custom-auth-configs) for the general flow. Composio sends the key as a bearer token to `https://api.instantly.ai`. |
| 28 | |
| 29 | ### Scopes |
| 30 | |
| 31 | Instantly API keys are scoped when you create them, and you can't change a key's scopes afterward. To change permissions, create a new key and reconnect the account with it. |
| 32 | |
| 33 | Scopes follow a `resource:action` pattern, such as `campaigns:read`, `leads:create`, or `analytics:read`. Resources include `campaigns`, `leads`, `lead_lists`, `accounts`, `ai_agents`, `inbox_tests`, `webhooks`, and `api_keys`. `all:all` grants full read, create, update, and delete access to every endpoint. Prefer resource-level scopes, and use `all:all` only if your integration needs everything. |