# Instantly API Docs

- [Introduction](https://developer.instantly.ai/index.md): Build and manage Instantly integrations with API v2.
- [Quickstart](https://developer.instantly.ai/quickstart.md): Create an API key and make your first Instantly API v2 request.
- [Slack channel](https://developer.instantly.ai/getting-started/slack-channel.md): Join the Instantly developer Slack community to discuss APIs, ask questions, and share feedback.
- [Introduction](https://developer.instantly.ai/api-reference/introduction.md): This documentation is for the second version of the Instantly API.
- [Getting Started](https://developer.instantly.ai/getting-started/getting-started.md): Please read the guide below to get started with the second version of our API.
- [Authorization](https://developer.instantly.ai/getting-started/authorization.md): Instantly API Authorization Guide
- [Rate Limit](https://developer.instantly.ai/getting-started/rate-limit.md): Learn about the API rate limits and how to handle them.
- [API v1 to v2 migration](https://developer.instantly.ai/guides/api-v1-migration.md): Endpoint mapping and migration guide for moving from API v1 to API v2.
- [OAuth connection flow](https://developer.instantly.ai/guides/oauth-connection-flow.md): Programmatically connect Google and Microsoft OAuth accounts to your Instantly workspace.
- [Webhook events](https://developer.instantly.ai/guides/webhook-events.md): Schema reference and event types for Instantly webhook payloads.
- [Workspace group](https://developer.instantly.ai/guides/workspace-group.md): Manage multiple sub workspaces from a single admin workspace using the workspace group feature.
- [Get campaigns associated with an email](https://developer.instantly.ai/api-reference/accountcampaignmapping/get-campaigns-associated-with-an-email.md): Requires one of the following scopes: `account_campaign_mappings:read`, `account_campaign_mappings:all`, `all:read`, `all:all`
- [List account](https://developer.instantly.ai/api-reference/account/list-account.md): Requires one of the following scopes: `accounts:read`, `accounts:all`, `all:read`, `all:all`
- [Create account](https://developer.instantly.ai/api-reference/account/create-account.md): Requires one of the following scopes: `accounts:create`, `accounts:all`, `all:create`, `all:all`
- [Get account](https://developer.instantly.ai/api-reference/account/get-account.md): Requires one of the following scopes: `accounts:read`, `accounts:all`, `all:read`, `all:all`
- [Delete account](https://developer.instantly.ai/api-reference/account/delete-account.md): Requires one of the following scopes: `accounts:delete`, `accounts:all`, `all:delete`, `all:all`
- [Patch account](https://developer.instantly.ai/api-reference/account/patch-account.md): Requires one of the following scopes: `accounts:update`, `accounts:all`, `all:update`, `all:all`
- [Enable warmup for accounts](https://developer.instantly.ai/api-reference/account/enable-warmup-for-accounts.md): Initiates a background job to enable warmup for the specified accounts. The response will contain the initial background job object. You can monitor the job's progress by polling the `GET: /api/v2/background-jobs/:id` endpoint.
- [Disable warmup for accounts](https://developer.instantly.ai/api-reference/account/disable-warmup-for-accounts.md): Initiates a background job to disable warmup for the specified accounts. The response will contain the initial background job object. You can monitor the job's progress by polling the `GET: /api/v2/background-jobs/:id` endpoint.
- [Get warmup analytics](https://developer.instantly.ai/api-reference/account/get-warmup-analytics.md): Requires one of the following scopes: `accounts:read`, `accounts:all`, `all:read`, `all:all`
- [Get daily account analytics](https://developer.instantly.ai/api-reference/account/get-daily-account-analytics.md): Get daily account analytics showing the number of emails sent per day for each email account. Useful for tracking daily sending activity across your accounts.
- [Pause multiple accounts](https://developer.instantly.ai/api-reference/account/pause-multiple-accounts.md): Pauses up to 100 email accounts in the authenticated workspace. Each unique email is returned in either `paused_emails` or `failed_emails`.
- [Pause an account](https://developer.instantly.ai/api-reference/account/pause-an-account.md): Requires one of the following scopes: `accounts:update`, `accounts:all`, `all:update`, `all:all`
- [Resume a paused account](https://developer.instantly.ai/api-reference/account/resume-a-paused-account.md): Requires one of the following scopes: `accounts:update`, `accounts:all`, `all:update`, `all:all`
- [Mark an account as fixed](https://developer.instantly.ai/api-reference/account/mark-an-account-as-fixed.md): Sets the account to active and clears leftover error metadata such as status_message. Idempotent when the account is already active.
- [Get custom tracking domain status](https://developer.instantly.ai/api-reference/account/get-custom-tracking-domain-status.md): Requires one of the following scopes: `accounts:read`, `accounts:all`, `all:read`, `all:all`
- [Test account vitals](https://developer.instantly.ai/api-reference/account/test-account-vitals.md): Requires one of the following scopes: `accounts:read`, `accounts:all`, `all:read`, `all:all`
- [Move accounts between workspaces](https://developer.instantly.ai/api-reference/account/move-accounts-between-workspaces.md): Move accounts between workspaces. IMPORTANT: this endpoint should be called ONLY with an ADMIN workspace API key (check the workspace group docs: https://developer.instantly.ai/workspace-group), and both the source and destination workspaces must have the same admin workspace.
- [List AI agent items](https://developer.instantly.ai/api-reference/engageitem/list-ai-agent-items.md): Requires one of the following scopes: `all:read`, `all:all`
- [Bulk delete AI agent items](https://developer.instantly.ai/api-reference/engageitem/bulk-delete-ai-agent-items.md): Requires one of the following scopes: `all:delete`, `all:all`
- [List api key](https://developer.instantly.ai/api-reference/apikey/list-api-key.md): Requires one of the following scopes: `api_keys:read`, `api_keys:all`, `all:read`, `all:all`
- [Create api key](https://developer.instantly.ai/api-reference/apikey/create-api-key.md): Requires one of the following scopes: `api_keys:create`, `api_keys:all`, `all:create`, `all:all`
- [Delete api key](https://developer.instantly.ai/api-reference/apikey/delete-api-key.md): Requires one of the following scopes: `api_keys:delete`, `api_keys:all`, `all:delete`, `all:all`
- [List audit log](https://developer.instantly.ai/api-reference/auditlog/list-audit-log.md): Requires one of the following scopes: `audit_logs:read`, `audit_logs:all`, `all:read`, `all:all`
- [List background job](https://developer.instantly.ai/api-reference/backgroundjob/list-background-job.md): Requires one of the following scopes: `background-jobs:read`, `background-jobs:all`, `all:read`, `all:all`
- [Get background job](https://developer.instantly.ai/api-reference/backgroundjob/get-background-job.md): Requires one of the following scopes: `background-jobs:read`, `background-jobs:all`, `all:read`, `all:all`
- [List block list entry](https://developer.instantly.ai/api-reference/blocklistentry/list-block-list-entry.md): Requires one of the following scopes: `block_list_entries:read`, `block_list_entries:all`, `all:read`, `all:all`
- [Create block list entry](https://developer.instantly.ai/api-reference/blocklistentry/create-block-list-entry.md): Requires one of the following scopes: `block_list_entries:create`, `block_list_entries:all`, `all:create`, `all:all`
- [Delete all block list entries](https://developer.instantly.ai/api-reference/blocklistentry/delete-all-block-list-entries.md): Requires one of the following scopes: `block_list_entries:delete`, `block_list_entries:all`, `all:delete`, `all:all`
- [Get block list entry](https://developer.instantly.ai/api-reference/blocklistentry/get-block-list-entry.md): Requires one of the following scopes: `block_list_entries:read`, `block_list_entries:all`, `all:read`, `all:all`
- [Delete block list entry](https://developer.instantly.ai/api-reference/blocklistentry/delete-block-list-entry.md): Requires one of the following scopes: `block_list_entries:delete`, `block_list_entries:all`, `all:delete`, `all:all`
- [Patch block list entry](https://developer.instantly.ai/api-reference/blocklistentry/patch-block-list-entry.md): Requires one of the following scopes: `block_list_entries:update`, `block_list_entries:all`, `all:update`, `all:all`
- [Bulk create block list entry](https://developer.instantly.ai/api-reference/blocklistentry/bulk-create-block-list-entry.md): Requires one of the following scopes: `block_list_entries:create`, `block_list_entries:all`, `all:create`, `all:all`
- [Bulk delete block list entry](https://developer.instantly.ai/api-reference/blocklistentry/bulk-delete-block-list-entry.md): Requires one of the following scopes: `block_list_entries:delete`, `block_list_entries:all`, `all:delete`, `all:all`
- [Download all block list entries as CSV](https://developer.instantly.ai/api-reference/blocklistentry/download-all-block-list-entries-as-csv.md): Requires one of the following scopes: `block_list_entries:read`, `block_list_entries:all`, `all:read`, `all:all`
- [List campaign](https://developer.instantly.ai/api-reference/campaign/list-campaign.md): Requires one of the following scopes: `campaigns:read`, `campaigns:all`, `all:read`, `all:all`
- [Create campaign](https://developer.instantly.ai/api-reference/campaign/create-campaign.md): Requires one of the following scopes: `campaigns:create`, `campaigns:all`, `all:create`, `all:all`
- [Activate(start), or resume a campaign](https://developer.instantly.ai/api-reference/campaign/activatestart-or-resume-a-campaign.md): Requires one of the following scopes: `campaigns:update`, `campaigns:all`, `all:update`, `all:all`
- [Stop(or pause) a campaign](https://developer.instantly.ai/api-reference/campaign/stopor-pause-a-campaign.md): Requires one of the following scopes: `campaigns:update`, `campaigns:all`, `all:update`, `all:all`
- [Get campaign](https://developer.instantly.ai/api-reference/campaign/get-campaign.md): Requires one of the following scopes: `campaigns:read`, `campaigns:all`, `all:read`, `all:all`
- [Delete campaign](https://developer.instantly.ai/api-reference/campaign/delete-campaign.md): Requires one of the following scopes: `campaigns:delete`, `campaigns:all`, `all:delete`, `all:all`
- [Patch campaign](https://developer.instantly.ai/api-reference/campaign/patch-campaign.md): Requires one of the following scopes: `campaigns:update`, `campaigns:all`, `all:update`, `all:all`
- [Search campaigns by lead email](https://developer.instantly.ai/api-reference/campaign/search-campaigns-by-lead-email.md): Requires one of the following scopes: `campaigns:read`, `campaigns:all`, `all:read`, `all:all`
- [Get campaign(s) analytics](https://developer.instantly.ai/api-reference/campaign/get-campaigns-analytics.md): Get analytics for one or multiple campaigns. Specify the `id` field to get the analytics for a single campaign, or leave it empty to get the analytics for all campaigns
- [Get campaign(s) analytics overview](https://developer.instantly.ai/api-reference/campaign/get-campaigns-analytics-overview.md): Get analytics overview for one or multiple campaigns. Specify the `id` field to get the analytics overview for a single campaign, or leave it empty to get the analytics overview for all campaigns.
- [Get daily campaign analytics](https://developer.instantly.ai/api-reference/campaign/get-daily-campaign-analytics.md): Get campaign daily analytics
- [Get campaign steps analytics](https://developer.instantly.ai/api-reference/campaign/get-campaign-steps-analytics.md): Get campaign steps analytics
- [Share a campaign](https://developer.instantly.ai/api-reference/campaign/share-a-campaign.md): Share a campaign. This allows other users to create new campaigns based on this campaign. The campaign is being shared for 7 days, after which you'll have to call this endpoint again if you want to enable sharing on the campaign
- [Create campaign from shared one](https://developer.instantly.ai/api-reference/campaign/create-campaign-from-shared-one.md): Requires one of the following scopes: `campaigns:create`, `campaigns:all`, `all:create`, `all:all`
- [Export campaign to JSON format](https://developer.instantly.ai/api-reference/campaign/export-campaign-to-json-format.md): Requires one of the following scopes: `campaigns:read`, `campaigns:all`, `all:read`, `all:all`
- [Duplicate campaign](https://developer.instantly.ai/api-reference/campaign/duplicate-campaign.md): Requires one of the following scopes: `campaigns:create`, `campaigns:all`, `all:create`, `all:all`
- [Get launched campaigns count](https://developer.instantly.ai/api-reference/campaign/get-launched-campaigns-count.md): Requires one of the following scopes: `campaigns:read`, `campaigns:all`, `all:read`, `all:all`
- [Add campaign variables](https://developer.instantly.ai/api-reference/campaign/add-campaign-variables.md): Requires one of the following scopes: `campaigns:update`, `campaigns:all`, `all:update`, `all:all`
- [Get campaign sending status](https://developer.instantly.ai/api-reference/campaign/get-campaign-sending-status.md): Returns sending status data explaining why a campaign may not be sending emails or is sending slower than expected. Note: Some fields may be missing when the campaign is out of schedule. Always-present fields: campaign_id, last_updated, status, issue_tracking.
- [List phone numbers](https://developer.instantly.ai/api-reference/crmactions/list-phone-numbers.md): Retrieve all phone numbers associated with the current organization.
- [Delete phone number](https://developer.instantly.ai/api-reference/crmactions/delete-phone-number.md): Remove a phone number from the organization. Provider cleanup is retried automatically if delayed. Deleting an unknown or already removed number returns 404. A number that cannot be released because the workspace has no phone account returns 409 and is kept.
- [List custom tag mapping](https://developer.instantly.ai/api-reference/customtagmapping/list-custom-tag-mapping.md): Requires one of the following scopes: `custom_tag_mappings:read`, `custom_tag_mappings:all`, `all:read`, `all:all`
- [List custom tag](https://developer.instantly.ai/api-reference/customtag/list-custom-tag.md): Requires one of the following scopes: `custom_tags:read`, `custom_tags:all`, `all:read`, `all:all`
- [Create custom tag](https://developer.instantly.ai/api-reference/customtag/create-custom-tag.md): Requires one of the following scopes: `custom_tags:create`, `custom_tags:all`, `all:create`, `all:all`
- [Get custom tag](https://developer.instantly.ai/api-reference/customtag/get-custom-tag.md): Requires one of the following scopes: `custom_tags:read`, `custom_tags:all`, `all:read`, `all:all`
- [Delete custom tag](https://developer.instantly.ai/api-reference/customtag/delete-custom-tag.md): Requires one of the following scopes: `custom_tags:delete`, `custom_tags:all`, `all:delete`, `all:all`
- [Patch custom tag](https://developer.instantly.ai/api-reference/customtag/patch-custom-tag.md): Requires one of the following scopes: `custom_tags:update`, `custom_tags:all`, `all:update`, `all:all`
- [Assign or unassign tags to resources](https://developer.instantly.ai/api-reference/customtag/assign-or-unassign-tags-to-resources.md): This can be used for both accounts and campaigns. Please check the `resource_type` field for more information.
- [List dfy email account order](https://developer.instantly.ai/api-reference/dfyemailaccountorder/list-dfy-email-account-order.md): Requires one of the following scopes: `dfy_email_account_orders:read`, `dfy_email_account_orders:all`, `all:read`, `all:all`
- [Place a DFY email account order](https://developer.instantly.ai/api-reference/dfyemailaccountorder/place-a-dfy-email-account-order.md): Place a Done-For-You (DFY) email account order for your workspace.
- [Generate similar available domains](https://developer.instantly.ai/api-reference/dfyemailaccountorder/generate-similar-available-domains.md): This endpoint will generate a list of similar AND available domains based on the provided domain.. It will return a maximum number of 67 suggestions per extension (tld) requested.. All the returned domains will be available for order.. Domains containing trademarks of well-known companies are restri…
- [Check domains availability](https://developer.instantly.ai/api-reference/dfyemailaccountorder/check-domains-availability.md): This endpoint will check the availability of the provided domains.. It will return a list of domains with their availability status.
- [Get pre-warmed up domains](https://developer.instantly.ai/api-reference/dfyemailaccountorder/get-pre-warmed-up-domains.md): This endpoint will return a list of pre-warmed up domains available for order.<br/>These domains are set up and configured in advance, allowing for quick deployment of email services.<br/>Use this endpoint to retrieve available pre-warmed up domains before placing an order.<br/><br/><b>IMPORTANT: if…
- [List DFY ordered email accounts](https://developer.instantly.ai/api-reference/dfyemailaccountorder/list-dfy-ordered-email-accounts.md): This endpoint will return a list of DFY email accounts ordered
- [Cancel dfy email accounts](https://developer.instantly.ai/api-reference/dfyemailaccountorder/cancel-dfy-email-accounts.md): This endpoint will cancel the DFY email accounts based on the provided email addresses. Cancelling permanently deletes all Unibox emails and conversations associated with the cancelled accounts. This cannot be undone.
- [Get domain forwarding](https://developer.instantly.ai/api-reference/domainforwarding/get-domain-forwarding.md): Returns the stored web forwarding configuration for a domain ordered through Instantly. All fields except `domain` are null when no forwarding is configured.
- [Set domain forwarding](https://developer.instantly.ai/api-reference/domainforwarding/set-domain-forwarding.md): Sets web forwarding on a domain ordered through Instantly. The forwarding domain must be a valid domain different from the domain itself. Returns a conflict error while the domain order is still being provisioned, and an unprocessable entity error when the requested forwarding configuration is not s…
- [Remove domain forwarding](https://developer.instantly.ai/api-reference/domainforwarding/remove-domain-forwarding.md): Removes web forwarding from a domain ordered through Instantly. This operation is idempotent: removing forwarding from a domain that has none configured succeeds without changes. This request has a rate limit of 10 requests per minute, or 60 requests per hour.
- [Send a test email](https://developer.instantly.ai/api-reference/email/send-a-test-email.md): Send a preview/test email without creating an email entity in Unibox. Rate limit: 10 requests per minute per workspace.
- [Reply to an email](https://developer.instantly.ai/api-reference/email/reply-to-an-email.md): Send a reply to an email. This endpoint can be used to send an email only as a reply to an existing email. In order to reply to an email, please specify the `reyply_to_uuid` field, and your email will be sent as a reply to that email. The `reyply_to_uuid` field represents the `id` field of an existi…
- [Forward an email](https://developer.instantly.ai/api-reference/email/forward-an-email.md): Forward an existing email to another recipient. You must specify the `reply_to_uuid` field, which represents the `id` of an existing email returned by the `/emails` endpoints. By default only the provided body is sent. Set `include_original_body` to `true` to append the original email context.
- [List email](https://developer.instantly.ai/api-reference/email/list-email.md): **Rate Limit:** This endpoint has a rate limit of 20 requests per minute, unlike other API endpoints.
- [Get email](https://developer.instantly.ai/api-reference/email/get-email.md): Requires one of the following scopes: `emails:read`, `emails:all`, `all:read`, `all:all`
- [Delete email](https://developer.instantly.ai/api-reference/email/delete-email.md): Requires one of the following scopes: `emails:delete`, `emails:all`, `all:delete`, `all:all`
- [Patch email](https://developer.instantly.ai/api-reference/email/patch-email.md): Requires one of the following scopes: `emails:update`, `emails:all`, `all:update`, `all:all`
- [Count unread emails](https://developer.instantly.ai/api-reference/email/count-unread-emails.md): Requires one of the following scopes: `emails:read`, `emails:all`, `all:read`, `all:all`
- [Mark all emails in a thread as read](https://developer.instantly.ai/api-reference/email/mark-all-emails-in-a-thread-as-read.md): Requires one of the following scopes: `emails:update`, `emails:all`, `all:update`, `all:all`
- [List inbox placement analytics](https://developer.instantly.ai/api-reference/inboxplacementanalytics/list-inbox-placement-analytics.md): Requires one of the following scopes: `inbox_placement_analytics:read`, `inbox_placement_analytics:all`, `all:read`, `all:all`
- [Get inbox placement analytics](https://developer.instantly.ai/api-reference/inboxplacementanalytics/get-inbox-placement-analytics.md): Requires one of the following scopes: `inbox_placement_analytics:read`, `inbox_placement_analytics:all`, `all:read`, `all:all`
- [Retrieve inbox placement analytics stats by test id](https://developer.instantly.ai/api-reference/inboxplacementanalytics/retrieve-inbox-placement-analytics-stats-by-test-id.md): Provides aggregated inbox, spam and category counts for specified test IDs
- [Retrieve inbox placement analytics deliverability insights](https://developer.instantly.ai/api-reference/inboxplacementanalytics/retrieve-inbox-placement-analytics-deliverability-insights.md): Provides deliverability insights for a specific inbox placement test
- [Get inbox placement analytics stats by date](https://developer.instantly.ai/api-reference/inboxplacementanalytics/get-inbox-placement-analytics-stats-by-date.md): Provides a time series representing the distribution of emails sent to inbox, spam, or category folders for scheduled inbox placement tests.
- [List inbox placement blacklist and spamassassin report](https://developer.instantly.ai/api-reference/inboxplacementblacklistandspamassassinreport/list-inbox-placement-blacklist-and-spamassassin-report.md): Requires one of the following scopes: `inbox_placement_reports:read`, `inbox_placement_reports:all`, `all:read`, `all:all`
- [Get inbox placement blacklist and spamassassin report](https://developer.instantly.ai/api-reference/inboxplacementblacklistandspamassassinreport/get-inbox-placement-blacklist-and-spamassassin-report.md): Requires one of the following scopes: `inbox_placement_reports:read`, `inbox_placement_reports:all`, `all:read`, `all:all`
- [List inbox placement test](https://developer.instantly.ai/api-reference/inboxplacementtest/list-inbox-placement-test.md): Requires one of the following scopes: `inbox_placement_tests:read`, `inbox_placement_tests:all`, `all:read`, `all:all`
- [Create inbox placement test](https://developer.instantly.ai/api-reference/inboxplacementtest/create-inbox-placement-test.md): Requires one of the following scopes: `inbox_placement_tests:create`, `inbox_placement_tests:all`, `all:create`, `all:all`
- [Get inbox placement test](https://developer.instantly.ai/api-reference/inboxplacementtest/get-inbox-placement-test.md): Requires one of the following scopes: `inbox_placement_tests:read`, `inbox_placement_tests:all`, `all:read`, `all:all`
- [Delete inbox placement test](https://developer.instantly.ai/api-reference/inboxplacementtest/delete-inbox-placement-test.md): Requires one of the following scopes: `inbox_placement_tests:delete`, `inbox_placement_tests:all`, `all:delete`, `all:all`
- [Patch inbox placement test](https://developer.instantly.ai/api-reference/inboxplacementtest/patch-inbox-placement-test.md): Requires one of the following scopes: `inbox_placement_tests:update`, `inbox_placement_tests:all`, `all:update`, `all:all`
- [Get ESP options](https://developer.instantly.ai/api-reference/inboxplacementtest/get-esp-options.md): Provides a list of available email service providers for inbox placement tests.
- [List lead label](https://developer.instantly.ai/api-reference/leadlabel/list-lead-label.md): Requires one of the following scopes: `lead-labels:read`, `lead-labels:all`, `all:read`, `all:all`
- [Create lead label](https://developer.instantly.ai/api-reference/leadlabel/create-lead-label.md): Requires one of the following scopes: `lead-labels:create`, `lead-labels:all`, `all:create`, `all:all`
- [Get lead label](https://developer.instantly.ai/api-reference/leadlabel/get-lead-label.md): Requires one of the following scopes: `lead-labels:read`, `lead-labels:all`, `all:read`, `all:all`
- [Delete lead label](https://developer.instantly.ai/api-reference/leadlabel/delete-lead-label.md): Requires one of the following scopes: `lead-labels:delete`, `lead-labels:all`, `all:delete`, `all:all`
- [Patch lead label](https://developer.instantly.ai/api-reference/leadlabel/patch-lead-label.md): Requires one of the following scopes: `lead-labels:update`, `lead-labels:all`, `all:update`, `all:all`
- [Test AI reply label prediction](https://developer.instantly.ai/api-reference/leadlabel/test-ai-reply-label-prediction.md): Returns the AI-predicted lead label for a reply text. This simulates how AI auto-tagging would label an incoming reply for testing custom labels and descriptions. Rate limit: 500 requests per 30 days per workspace. This rate limit applies only to this testing endpoint; live reply processing does not…
- [List lead list](https://developer.instantly.ai/api-reference/leadlist/list-lead-list.md): Requires one of the following scopes: `lead_lists:read`, `lead_lists:all`, `all:read`, `all:all`
- [Create lead list](https://developer.instantly.ai/api-reference/leadlist/create-lead-list.md): Requires one of the following scopes: `lead_lists:create`, `lead_lists:all`, `all:create`, `all:all`
- [Get lead list](https://developer.instantly.ai/api-reference/leadlist/get-lead-list.md): Requires one of the following scopes: `lead_lists:read`, `lead_lists:all`, `all:read`, `all:all`
- [Delete lead list](https://developer.instantly.ai/api-reference/leadlist/delete-lead-list.md): Requires one of the following scopes: `lead_lists:delete`, `lead_lists:all`, `all:delete`, `all:all`
- [Patch lead list](https://developer.instantly.ai/api-reference/leadlist/patch-lead-list.md): Requires one of the following scopes: `lead_lists:update`, `lead_lists:all`, `all:update`, `all:all`
- [Get verification statistics for a lead list](https://developer.instantly.ai/api-reference/leadlist/get-verification-statistics-for-a-lead-list.md): Get verification statistics for a lead list
- [Create lead](https://developer.instantly.ai/api-reference/lead/create-lead.md): Requires one of the following scopes: `leads:create`, `leads:all`, `all:create`, `all:all`
- [Delete leads in bulk](https://developer.instantly.ai/api-reference/lead/delete-leads-in-bulk.md): Delete multiple leads from a campaign or list based on filters. You must provide either `campaign_id` or `list_id`. Optionally filter by status or specific IDs.
- [List leads](https://developer.instantly.ai/api-reference/lead/list-leads.md): This endpoint is a POST endpoint, instead of GET - a deviation from the REST APIs standards we’re following because of the complex arguments it accepts, which would be too hard to express through query parameters. Results are ordered by each lead's `id` field in ascending order (or by `contact` when…
- [Get lead](https://developer.instantly.ai/api-reference/lead/get-lead.md): Requires one of the following scopes: `leads:read`, `leads:all`, `all:read`, `all:all`
- [Delete lead](https://developer.instantly.ai/api-reference/lead/delete-lead.md): Requires one of the following scopes: `leads:delete`, `leads:all`, `all:delete`, `all:all`
- [Patch lead](https://developer.instantly.ai/api-reference/lead/patch-lead.md): Requires one of the following scopes: `leads:update`, `leads:all`, `all:update`, `all:all`
- [Merge two leads](https://developer.instantly.ai/api-reference/lead/merge-two-leads.md): Merge two leads
- [Update the interest status of a lead](https://developer.instantly.ai/api-reference/lead/update-the-interest-status-of-a-lead.md): Update the interest status of a lead
- [Remove a lead from a subsequence](https://developer.instantly.ai/api-reference/lead/remove-a-lead-from-a-subsequence.md): Remove a lead from a subsequence
- [Bulk assign leads to organization users](https://developer.instantly.ai/api-reference/lead/bulk-assign-leads-to-organization-users.md): Bulk assign leads to organization users
- [Move leads to a campaign or list](https://developer.instantly.ai/api-reference/lead/move-leads-to-a-campaign-or-list.md): Move leads to a different campaign or list. This endpoint will return a background job that will process the move. The job will be processed in the background and the leads will be moved to the destination campaign or list. You can use the `/background-jobs/:id` endpoint to check the job status. Not…
- [Move a lead to a subsequence](https://developer.instantly.ai/api-reference/lead/move-a-lead-to-a-subsequence.md): Move a lead to a subsequence
- [Add leads in bulk to a campaign or list](https://developer.instantly.ai/api-reference/lead/add-leads-in-bulk-to-a-campaign-or-list.md): Adds up to 1000 leads to either a campaign or a list. You must provide a `campaign_id` or a `list_id`, but not both. The endpoint validates emails, checks against blocklists and existing leads.
- [Initialize google oauth](https://developer.instantly.ai/api-reference/oauth/initialize-google-oauth.md): Creates an OAuth session and returns the Google authorization URL. The user should be redirected to auth_url to complete the OAuth flow. Poll the status endpoint to check for completion.
- [Initialize microsoft oauth](https://developer.instantly.ai/api-reference/oauth/initialize-microsoft-oauth.md): Creates an OAuth session and returns the Microsoft authorization URL. The user should be redirected to auth_url to complete the OAuth flow. Poll the status endpoint to check for completion.
- [Get oauth session status](https://developer.instantly.ai/api-reference/oauth/get-oauth-session-status.md): Poll this endpoint to check the OAuth session result. Works for both Google and Microsoft OAuth sessions. Returns pending while waiting, success with account details when complete, or error if something went wrong. Sessions expire after 10 minutes.
- [Facet keywords for a signal category](https://developer.instantly.ai/api-reference/supersearchenrichment/facet-keywords-for-a-signal-category.md): Return the top matching keyword tokens for a given signal category and keyword field, aggregated from the last 90 days of signal data. Powers the Signals filter autocomplete in the Lead Finder. Unknown (category, field) pairs return 400.
- [Create AI enrichment](https://developer.instantly.ai/api-reference/supersearchenrichment/create-ai-enrichment.md): Create an AI enrichment for a resource (list or campaign)
- [Get AI enrichment for resource](https://developer.instantly.ai/api-reference/supersearchenrichment/get-ai-enrichment-for-resource.md): Get the AI enrichment for a specific resource
- [Get enrichment for resource](https://developer.instantly.ai/api-reference/supersearchenrichment/get-enrichment-for-resource.md): Get the enrichment for a specific resource
- [Create an enrichment](https://developer.instantly.ai/api-reference/supersearchenrichment/create-an-enrichment.md): Create an enrichment for a specific resource (list or campaign). This is the main endpoint for adding enrichments to resources. The enrichments are automatically run after creation. A `custom_flow` type requires `custom_flow`: a non-empty list of distinct email provider ids, spelled exactly as liste…
- [Update enrichment settings for resource](https://developer.instantly.ai/api-reference/supersearchenrichment/update-enrichment-settings-for-resource.md): Update auto-update and skip settings for a SuperSearch enrichment tied to a specific resource
- [Enrich leads from supersearch](https://developer.instantly.ai/api-reference/supersearchenrichment/enrich-leads-from-supersearch.md): Add leads from SuperSearch to a list and enrich them. A list is automatically created if no list is provided.
- [Run enrichment for resource](https://developer.instantly.ai/api-reference/supersearchenrichment/run-enrichment-for-resource.md): Run all enrichments associated with a resource for a list of leads or for all the leads that haven't been enriched yet
- [Count leads from supersearch](https://developer.instantly.ai/api-reference/supersearchenrichment/count-leads-from-supersearch.md): Count the number of leads matching a SuperSearch query without enriching them. This endpoint is intended to estimate lead availability before running an enrichment.
- [Preview leads from supersearch](https://developer.instantly.ai/api-reference/supersearchenrichment/preview-leads-from-supersearch.md): Preview the leads matching a SuperSearch query without enriching them
- [Get enrichment history](https://developer.instantly.ai/api-reference/supersearchenrichment/get-enrichment-history.md): Retrieve the enrichment history for a specific resource
- [Returns the full integration provider registry](https://developer.instantly.ai/api-reference/supersearchenrichment/returns-the-full-integration-provider-registry.md): Returns every data-provider integration with its available lookup actions, per-action credit cost, and whether the requesting workspace has connected its own provider account (isConnected). credentialSource names whose key runs the provider for the requesting workspace ("workspace_key", "instantly_k…
- [Run a single integration lookup action synchronously](https://developer.instantly.ai/api-reference/supersearchenrichment/run-a-single-integration-lookup-action-synchronously.md): Executes one lookup action for a single record with literal inputs and returns the provider payload inline, under the action's output column.
- [List saved searches](https://developer.instantly.ai/api-reference/supersearchenrichment/list-saved-searches.md): List the workspace's saved SuperSearch queries, newest first.
- [Save a search](https://developer.instantly.ai/api-reference/supersearchenrichment/save-a-search.md): Save a SuperSearch query for reuse. `search_filters` uses the same shape as the count, preview and enrich endpoints.
- [Get a saved search](https://developer.instantly.ai/api-reference/supersearchenrichment/get-a-saved-search.md): Requires one of the following scopes: `supersearch_enrichments:read`, `supersearch_enrichments:all`, `all:read`, `all:all`
- [Delete a saved search](https://developer.instantly.ai/api-reference/supersearchenrichment/delete-a-saved-search.md): Requires one of the following scopes: `supersearch_enrichments:delete`, `supersearch_enrichments:all`, `all:delete`, `all:all`
- [Update a saved search](https://developer.instantly.ai/api-reference/supersearchenrichment/update-a-saved-search.md): Rename a saved search and/or replace its filters.
- [List campaign subsequence](https://developer.instantly.ai/api-reference/campaignsubsequence/list-campaign-subsequence.md): Requires one of the following scopes: `subsequences:read`, `subsequences:all`, `all:read`, `all:all`
- [Create campaign subsequence](https://developer.instantly.ai/api-reference/campaignsubsequence/create-campaign-subsequence.md): Requires one of the following scopes: `subsequences:create`, `subsequences:all`, `all:create`, `all:all`
- [Duplicate a subsequence](https://developer.instantly.ai/api-reference/campaignsubsequence/duplicate-a-subsequence.md): Duplicate a subsequence with the same trigger conditions
- [Pause a subsequence](https://developer.instantly.ai/api-reference/campaignsubsequence/pause-a-subsequence.md): Pause a subsequence
- [Resume a paused subsequence](https://developer.instantly.ai/api-reference/campaignsubsequence/resume-a-paused-subsequence.md): Resume a paused subsequence
- [Get subsequence analytics summary](https://developer.instantly.ai/api-reference/campaignsubsequence/get-subsequence-analytics-summary.md): Returns per-subsequence engagement totals (emails sent, unique opens, unique replies) for the subsequences of a campaign.
- [Get campaign subsequence](https://developer.instantly.ai/api-reference/campaignsubsequence/get-campaign-subsequence.md): Requires one of the following scopes: `subsequences:read`, `subsequences:all`, `all:read`, `all:all`
- [Delete campaign subsequence](https://developer.instantly.ai/api-reference/campaignsubsequence/delete-campaign-subsequence.md): Requires one of the following scopes: `subsequences:delete`, `subsequences:all`, `all:delete`, `all:all`
- [Patch campaign subsequence](https://developer.instantly.ai/api-reference/campaignsubsequence/patch-campaign-subsequence.md): Requires one of the following scopes: `subsequences:update`, `subsequences:all`, `all:update`, `all:all`
- [Get subsequence step and variant analytics](https://developer.instantly.ai/api-reference/campaignsubsequence/get-subsequence-step-and-variant-analytics.md): Returns engagement metrics grouped by zero-based step and variant for one subsequence. Results include only activity from the requested subsequence, excluding its parent campaign and sibling subsequences.
- [Get subsequence sending status](https://developer.instantly.ai/api-reference/campaignsubsequence/get-subsequence-sending-status.md): Returns sending status data explaining why a subsequence may not be sending emails or is sending slower than expected. Note: Some fields may be missing when the campaign is out of schedule. Always-present fields: campaign_id, subsequence_id, last_updated, status, issue_tracking.
- [Create email verification](https://developer.instantly.ai/api-reference/emailverification/create-email-verification.md): If an email takes longer than 10 seconds to verify, the endpoint will return the status as `pending`. In that case, you may use the `/email-verification/:email` endpoint to check the status of the verification job.
- [Check an email verification status](https://developer.instantly.ai/api-reference/emailverification/check-an-email-verification-status.md): Requires one of the following scopes: `email_verifications:read`, `email_verifications:all`, `all:read`, `all:all`
- [List webhook event](https://developer.instantly.ai/api-reference/webhookevent/list-webhook-event.md): Requires one of the following scopes: `webhook_events:read`, `webhook_events:all`, `all:read`, `all:all`
- [Get webhook event](https://developer.instantly.ai/api-reference/webhookevent/get-webhook-event.md): Requires one of the following scopes: `webhook_events:read`, `webhook_events:all`, `all:read`, `all:all`
- [Get overview aggregates for webhook events](https://developer.instantly.ai/api-reference/webhookevent/get-overview-aggregates-for-webhook-events.md): Get overview aggregates for webhook events including success/failure rates
- [Get overview aggregates for webhook events by date](https://developer.instantly.ai/api-reference/webhookevent/get-overview-aggregates-for-webhook-events-by-date.md): Get overview aggregates for webhook events by Date for charts
- [List webhooks](https://developer.instantly.ai/api-reference/webhook/list-webhooks.md): List all webhooks for the workspace with optional filters
- [Create webhook](https://developer.instantly.ai/api-reference/webhook/create-webhook.md): Requires one of the following scopes: `webhooks:create`, `webhooks:all`, `all:create`, `all:all`
- [Get webhook](https://developer.instantly.ai/api-reference/webhook/get-webhook.md): Requires one of the following scopes: `webhooks:read`, `webhooks:all`, `all:read`, `all:all`
- [Delete webhook](https://developer.instantly.ai/api-reference/webhook/delete-webhook.md): Requires one of the following scopes: `webhooks:delete`, `webhooks:all`, `all:delete`, `all:all`
- [Patch webhook](https://developer.instantly.ai/api-reference/webhook/patch-webhook.md): Requires one of the following scopes: `webhooks:update`, `webhooks:all`, `all:update`, `all:all`
- [List available event types](https://developer.instantly.ai/api-reference/webhook/list-available-event-types.md): Get all available webhook event types including custom labels
- [Test a webhook](https://developer.instantly.ai/api-reference/webhook/test-a-webhook.md): Send a test payload to a webhook URL to verify it is working
- [Resume a webhook](https://developer.instantly.ai/api-reference/webhook/resume-a-webhook.md): Resume a webhook that was disabled due to repeated delivery failures
- [Get workspace plan details](https://developer.instantly.ai/api-reference/workspacebilling/get-workspace-plan-details.md): Requires one of the following scopes: `workspace_billing:read`, `workspace_billing:all`, `all:read`, `all:all`
- [Get workspace subscription details](https://developer.instantly.ai/api-reference/workspacebilling/get-workspace-subscription-details.md): Requires one of the following scopes: `workspace_billing:read`, `workspace_billing:all`, `all:read`, `all:all`
- [List workspace group member](https://developer.instantly.ai/api-reference/workspacegroupmember/list-workspace-group-member.md): Requires one of the following scopes: `workspace_group_members:read`, `workspace_group_members:all`, `all:read`, `all:all`
- [Create workspace group member](https://developer.instantly.ai/api-reference/workspacegroupmember/create-workspace-group-member.md): This endpoint allows you to send an invitation for a sub workspace to join the admin workspace. The sub workspace will be added as a sub workspace of the admin workspace only if the sub workspace owner accepts the invitation.
- [Get workspace group member](https://developer.instantly.ai/api-reference/workspacegroupmember/get-workspace-group-member.md): Requires one of the following scopes: `workspace_group_members:read`, `workspace_group_members:all`, `all:read`, `all:all`
- [Delete workspace group member](https://developer.instantly.ai/api-reference/workspacegroupmember/delete-workspace-group-member.md): Requires one of the following scopes: `workspace_group_members:delete`, `workspace_group_members:all`, `all:delete`, `all:all`
- [Get the current workspace admin workspace](https://developer.instantly.ai/api-reference/workspacegroupmember/get-the-current-workspace-admin-workspace.md): Get the details of the admin workspace of the current workspace
- [List workspace member](https://developer.instantly.ai/api-reference/workspacemember/list-workspace-member.md): Requires one of the following scopes: `workspace_members:read`, `workspace_members:all`, `all:read`, `all:all`
- [Create workspace member](https://developer.instantly.ai/api-reference/workspacemember/create-workspace-member.md): Requires one of the following scopes: `workspace_members:create`, `workspace_members:all`, `all:create`, `all:all`
- [Get workspace member](https://developer.instantly.ai/api-reference/workspacemember/get-workspace-member.md): Requires one of the following scopes: `workspace_members:read`, `workspace_members:all`, `all:read`, `all:all`
- [Delete workspace member](https://developer.instantly.ai/api-reference/workspacemember/delete-workspace-member.md): Requires one of the following scopes: `workspace_members:delete`, `workspace_members:all`, `all:delete`, `all:all`
- [Patch workspace member](https://developer.instantly.ai/api-reference/workspacemember/patch-workspace-member.md): Requires one of the following scopes: `workspace_members:update`, `workspace_members:all`, `all:update`, `all:all`
- [Get workspace](https://developer.instantly.ai/api-reference/workspace/get-workspace.md): Get your current workspace details. Note that this endpoint doesn't require any parameters. It will return the workspace based on the API key sent in the headers.
- [Patch workspace](https://developer.instantly.ai/api-reference/workspace/patch-workspace.md): Update your current workspace details. Note that this endpoint doesn't require any parameters. It will update the workspace based on the API key sent in the headers.
- [Schedule Current Workspace Removal](https://developer.instantly.ai/api-reference/workspace/schedule-current-workspace-removal.md): Schedule the current workspace to be removed in 24 hours.
- [Cancel Current Workspace Removal](https://developer.instantly.ai/api-reference/workspace/cancel-current-workspace-removal.md): Requires one of the following scopes: `workspaces:delete`, `workspaces:all`, `all:delete`, `all:all`
- [Get organization verified agency domain information](https://developer.instantly.ai/api-reference/workspace/get-organization-verified-agency-domain-information.md): Requires one of the following scopes: `workspaces:read`, `workspaces:all`, `all:read`, `all:all`
- [Set the agency domain for the workspace](https://developer.instantly.ai/api-reference/workspace/set-the-agency-domain-for-the-workspace.md): Requires one of the following scopes: `workspaces:update`, `workspaces:all`, `all:update`, `all:all`
- [Delete organization agency domain](https://developer.instantly.ai/api-reference/workspace/delete-organization-agency-domain.md): Requires one of the following scopes: `workspaces:update`, `workspaces:all`, `all:update`, `all:all`
- [Change workspace owner](https://developer.instantly.ai/api-reference/workspace/change-workspace-owner.md): Requires one of the following scopes: `workspaces:update`, `workspaces:all`, `all:update`, `all:all`
- [List AI Sales Agents](https://developer.instantly.ai/api-reference/aisalesagent/list-ai-sales-agents.md): List the AI Sales Agents of the workspace, newest first.
- [Create an AI Sales Agent](https://developer.instantly.ai/api-reference/aisalesagent/create-an-ai-sales-agent.md): Create a new AI Sales Agent. Provide `type` and `input` to extract business details from a website or pitch deck, or skip the scrape by setting `memory_from_workspace` to true to copy the workspace business details, or `is_duplicate` with `source_ai_sdr_id` to copy an existing agent.
- [Get an AI Sales Agent](https://developer.instantly.ai/api-reference/aisalesagent/get-an-ai-sales-agent.md): Retrieve a single AI Sales Agent with its full configuration.
- [Delete an AI Sales Agent](https://developer.instantly.ai/api-reference/aisalesagent/delete-an-ai-sales-agent.md): Delete an AI Sales Agent. Returns the core fields of the deleted agent. Fails with a conflict while campaigns are still linked to the agent.
- [Update an AI Sales Agent](https://developer.instantly.ai/api-reference/aisalesagent/update-an-ai-sales-agent.md): Update an AI Sales Agent, including its configuration.
- [Get AI Sales Agent analytics](https://developer.instantly.ai/api-reference/aisalesagent/get-ai-sales-agent-analytics.md): Get daily analytics (leads found, emails sent, replies, opportunities, total email activity) merged across all campaigns of the AI Sales Agent. When `start_date` and `end_date` are omitted, the response covers all-time data.
- [Get AI Sales Agent opportunity summary](https://developer.instantly.ai/api-reference/aisalesagent/get-ai-sales-agent-opportunity-summary.md): Get aggregated opportunity counts by status and a per-campaign breakdown for all campaigns of the AI Sales Agent. When `start_date` and `end_date` are omitted, the response covers all-time data.
- [Get research sources for an AI Sales Agent lead](https://developer.instantly.ai/api-reference/aisalesagent/get-research-sources-for-an-ai-sales-agent-lead.md): Requires one of the following scopes: `ai_sdr:read`, `ai_sdr:all`, `all:read`, `all:all`
- [Get AI Sales Agent lead activity summary](https://developer.instantly.ai/api-reference/aisalesagent/get-ai-sales-agent-lead-activity-summary.md): Get aggregate counts and rates for lead activity across all campaigns of the AI Sales Agent. When `start_date` and `end_date` are omitted, the response covers all-time data.
- [List AI Sales Agent lead activity](https://developer.instantly.ai/api-reference/aisalesagent/list-ai-sales-agent-lead-activity.md): Get per-lead event history (emails sent, opens, replies, clicks, bounces, opportunity status) for all campaigns of the AI Sales Agent. Leads are ordered by email ascending and paginated with a cursor. When `start_date` and `end_date` are omitted, the response covers all-time data.
- [List AI Sales Agent activities](https://developer.instantly.ai/api-reference/aisalesagent/list-ai-sales-agent-activities.md): List all activities for the AI Sales Agent.
- [Approve an AI Sales Agent activity](https://developer.instantly.ai/api-reference/aisalesagent/approve-an-ai-sales-agent-activity.md): Approve a pending AI Sales Agent activity action. Returns 404 when the activity does not exist or is not pending.
- [Reject an AI Sales Agent activity](https://developer.instantly.ai/api-reference/aisalesagent/reject-an-ai-sales-agent-activity.md): Reject a pending AI Sales Agent activity action. Returns 404 when the activity does not exist or is not pending.
- [Approve multiple AI Sales Agent activities](https://developer.instantly.ai/api-reference/aisalesagent/approve-multiple-ai-sales-agent-activities.md): Approve multiple pending AI Sales Agent activity actions. Returns 404 when none of the activities exist or none are pending.
- [Reject multiple AI Sales Agent activities](https://developer.instantly.ai/api-reference/aisalesagent/reject-multiple-ai-sales-agent-activities.md): Reject multiple pending AI Sales Agent activity actions. Returns 404 when none of the activities exist or none are pending.
- [List AI Sales Agent guidance rules](https://developer.instantly.ai/api-reference/aisalesagent/list-ai-sales-agent-guidance-rules.md): List the guidance rules the AI Sales Agent follows when writing outreach. An agent has at most 10 rules, so the list is not paginated.
- [Create an AI Sales Agent guidance rule](https://developer.instantly.ai/api-reference/aisalesagent/create-an-ai-sales-agent-guidance-rule.md): Add a guidance rule the AI Sales Agent must follow when writing outreach. An agent can have at most 10 rules. Rules are stored as a single list, so concurrent writes to the same agent are last-write-wins — serialize them client-side.
- [Delete an AI Sales Agent guidance rule](https://developer.instantly.ai/api-reference/aisalesagent/delete-an-ai-sales-agent-guidance-rule.md): Delete a guidance rule. Rule ids are positional, so the remaining rules re-index after a deletion — re-fetch the list before acting on another rule. Rules are stored as a single list, so concurrent writes to the same agent are last-write-wins — serialize them client-side.
- [Update an AI Sales Agent guidance rule](https://developer.instantly.ai/api-reference/aisalesagent/update-an-ai-sales-agent-guidance-rule.md): Update the title or content of a guidance rule. Rules are stored as a single list, so concurrent writes to the same agent are last-write-wins — serialize them client-side.
- [List AI Inbox Managers](https://developer.instantly.ai/api-reference/aiinboxmanager/list-ai-inbox-managers.md): List the AI Inbox Managers of the workspace, newest first.
- [Create an AI Inbox Manager](https://developer.instantly.ai/api-reference/aiinboxmanager/create-an-ai-inbox-manager.md): Create a new AI Inbox Manager with its configuration and optional initial guidance, saved together. The agent is created active. Including guidance also requires the guidance creation scope.
- [Get an AI Inbox Manager](https://developer.instantly.ai/api-reference/aiinboxmanager/get-an-ai-inbox-manager.md): Retrieve a single AI Inbox Manager with its full configuration.
- [Delete an AI Inbox Manager](https://developer.instantly.ai/api-reference/aiinboxmanager/delete-an-ai-inbox-manager.md): Delete an AI Inbox Manager. Returns the core fields of the deleted agent.
- [Update an AI Inbox Manager](https://developer.instantly.ai/api-reference/aiinboxmanager/update-an-ai-inbox-manager.md): Update an AI Inbox Manager, including its configuration.
- [List AI Inbox Manager guidances](https://developer.instantly.ai/api-reference/aiinboxmanager/list-ai-inbox-manager-guidances.md): List the guidances configured for an AI Inbox Manager.
- [Create an AI Inbox Manager guidance](https://developer.instantly.ai/api-reference/aiinboxmanager/create-an-ai-inbox-manager-guidance.md): Create a guidance for an AI Inbox Manager. The BASICS category is an upsert: it carries tone/length options instead of an instruction, is always active, and an agent has at most one — creating a second one updates the existing guidance in place.
- [Get an AI Inbox Manager guidance](https://developer.instantly.ai/api-reference/aiinboxmanager/get-an-ai-inbox-manager-guidance.md): Retrieve a single guidance of an AI Inbox Manager.
- [Delete an AI Inbox Manager guidance](https://developer.instantly.ai/api-reference/aiinboxmanager/delete-an-ai-inbox-manager-guidance.md): Delete a guidance of an AI Inbox Manager.
- [Update an AI Inbox Manager guidance](https://developer.instantly.ai/api-reference/aiinboxmanager/update-an-ai-inbox-manager-guidance.md): Update a guidance of an AI Inbox Manager. BASICS guidances keep an empty instruction and stay active; a guidance cannot be changed to or from the BASICS category.
- [List AI Inbox Manager replies](https://developer.instantly.ai/api-reference/aiinboxmanager/list-ai-inbox-manager-replies.md): List the replies and follow-ups generated by an AI Inbox Manager, newest first.
- [Get an AI Inbox Manager reply](https://developer.instantly.ai/api-reference/aiinboxmanager/get-an-ai-inbox-manager-reply.md): Retrieve a single reply generated by an AI Inbox Manager, including its HTML body.
- [Update an AI Inbox Manager reply](https://developer.instantly.ai/api-reference/aiinboxmanager/update-an-ai-inbox-manager-reply.md): Update a reply generated by an AI Inbox Manager: leave feedback on the reply or mark its pending action as handled.
- [Get AI Inbox Manager analytics summary](https://developer.instantly.ai/api-reference/aiinboxmanager/get-ai-inbox-manager-analytics-summary.md): Get aggregated analytics for an AI Inbox Manager over an optional date window.
- [Get AI Inbox Manager analytics by date](https://developer.instantly.ai/api-reference/aiinboxmanager/get-ai-inbox-manager-analytics-by-date.md): Get daily analytics aggregates for an AI Inbox Manager over an optional date window.
- [List AI Inbox Manager activity](https://developer.instantly.ai/api-reference/aiinboxmanager/list-ai-inbox-manager-activity.md): Get the paginated unified activity feed (replies, follow-ups and no-show recoveries) for an AI Inbox Manager, newest first.
- [List AI Lead Finder Agents](https://developer.instantly.ai/api-reference/aileadfinderagent/list-ai-lead-finder-agents.md): List the AI Lead Finder Agents of the workspace, newest first.
- [Create an AI Lead Finder Agent](https://developer.instantly.ai/api-reference/aileadfinderagent/create-an-ai-lead-finder-agent.md): Create an AI Lead Finder Agent that keeps a campaign topped up with fresh leads. The agent immediately runs its first check after creation.
- [Get an AI Lead Finder Agent](https://developer.instantly.ai/api-reference/aileadfinderagent/get-an-ai-lead-finder-agent.md): Retrieve a single AI Lead Finder Agent with its full configuration.
- [Delete an AI Lead Finder Agent](https://developer.instantly.ai/api-reference/aileadfinderagent/delete-an-ai-lead-finder-agent.md): Delete an AI Lead Finder Agent. Leads it already added to the campaign stay in the campaign.
- [Update an AI Lead Finder Agent](https://developer.instantly.ai/api-reference/aileadfinderagent/update-an-ai-lead-finder-agent.md): Update an AI Lead Finder Agent's settings. `on_exhaustion: fallback` requires fallback filters, either in this request or already stored.
- [Pause an AI Lead Finder Agent](https://developer.instantly.ai/api-reference/aileadfinderagent/pause-an-ai-lead-finder-agent.md): Pause an AI Lead Finder Agent. A paused agent stops topping up its campaign until resumed.
- [Resume an AI Lead Finder Agent](https://developer.instantly.ai/api-reference/aileadfinderagent/resume-an-ai-lead-finder-agent.md): Resume a paused AI Lead Finder Agent. The agent immediately checks whether its campaign needs a top-up.
- [Get AI Lead Finder Agent lifetime stats](https://developer.instantly.ai/api-reference/aileadfinderagent/get-ai-lead-finder-agent-lifetime-stats.md): Lifetime activity totals of an AI Lead Finder Agent.
- [List AI Lead Finder Agent activities](https://developer.instantly.ai/api-reference/aileadfinderagent/list-ai-lead-finder-agent-activities.md): List the activity events of an AI Lead Finder Agent, newest first.
- [Suggest audiences from a campaign](https://developer.instantly.ai/api-reference/aileadfinderagent/suggest-audiences-from-a-campaign.md): Analyze the leads already in a campaign and suggest SuperSearch audiences that match them. Each suggestion returns a natural-language `query` plus store-format `filters`. Rate limited per workspace.
- [List saved enrichment workflows](https://developer.instantly.ai/api-reference/aileadfinderagent/list-saved-enrichment-workflows.md): Reusable AI-enrichment chains saved by the workspace, ready to apply to a Lead Finder Agent.
- [Save an enrichment workflow](https://developer.instantly.ai/api-reference/aileadfinderagent/save-an-enrichment-workflow.md): Save an AI-enrichment chain as a named, workspace-wide reusable workflow.
- [Delete a saved enrichment workflow](https://developer.instantly.ai/api-reference/aileadfinderagent/delete-a-saved-enrichment-workflow.md): Delete a saved workflow. Agents that already loaded it keep their copied chain.
- [Get the default AI Deliverability Agent](https://developer.instantly.ai/api-reference/aideliverabilityagent/get-the-default-ai-deliverability-agent.md): Retrieve the workspace default AI Deliverability Agent. The `agent` field is `null` if one has not been deployed. Use the returned `agent.id` with endpoints that require an agent ID.
- [Update the default AI Deliverability Agent settings](https://developer.instantly.ai/api-reference/aideliverabilityagent/update-the-default-ai-deliverability-agent-settings.md): Update Slack notification settings for the workspace default AI Deliverability Agent. Set `slack` to `null` to disconnect Slack notifications.
- [Get the default AI Deliverability Agent state](https://developer.instantly.ai/api-reference/aideliverabilityagent/get-the-default-ai-deliverability-agent-state.md): Get the live state of the workspace default AI Deliverability Agent, including current activity, schedule, latest run summary, and activity feed. If no agent has been deployed, this endpoint returns an empty state with `agent` set to `null`.
- [Pause accounts affected by a deliverability recommendation](https://developer.instantly.ai/api-reference/aideliverabilityagent/pause-accounts-affected-by-a-deliverability-recommendation.md): Pause active email accounts currently affected by the default agent's DNS-health or blocklist recommendation. The recommendation is revalidated before account statuses are changed. Calling this endpoint for an already completed feed item is idempotent.
- [Pause campaign sending for affected accounts](https://developer.instantly.ai/api-reference/aideliverabilityagent/pause-campaign-sending-for-affected-accounts.md): Pause campaign sending for 14 days on self-managed accounts affected by the default agent's bounce-health or warmup-score recommendation. Calling this endpoint for an already completed feed item is idempotent.
- [Complete a Deliverability Agent feed item](https://developer.instantly.ai/api-reference/aideliverabilityagent/complete-a-deliverability-agent-feed-item.md): Mark a supported pending recommendation complete after the default agent verifies that its underlying issue has been resolved. Currently, workspace-settings recommendations support manual completion. Calling this endpoint for an already completed feed item is idempotent.
- [Run Deliverability Agent now](https://developer.instantly.ai/api-reference/aideliverabilityagent/run-deliverability-agent-now.md): Requires one of the following scopes: `ai_agents:update`, `ai_agents:all`, `all:update`, `all:all`
- [Deploy the default AI Deliverability Agent](https://developer.instantly.ai/api-reference/aideliverabilityagent/deploy-the-default-ai-deliverability-agent.md): Create or reactivate the workspace default AI Deliverability Agent. This operation is idempotent when the agent is already active and schedules an initial cycle after deployment.
- [Get an AI Deliverability Agent](https://developer.instantly.ai/api-reference/aideliverabilityagent/get-an-ai-deliverability-agent.md): Retrieve a single AI Deliverability Agent.
- [Delete an AI Deliverability Agent](https://developer.instantly.ai/api-reference/aideliverabilityagent/delete-an-ai-deliverability-agent.md): Delete an AI Deliverability Agent, removing its activity history and any queued runs. Returns the core fields of the deleted agent. Deploying again creates a fresh agent.
- [Update an AI Deliverability Agent](https://developer.instantly.ai/api-reference/aideliverabilityagent/update-an-ai-deliverability-agent.md): Update an AI Deliverability Agent. Set `slack` to connect Slack notifications, or to null to disconnect them.
- [Get AI Deliverability Agent state](https://developer.instantly.ai/api-reference/aideliverabilityagent/get-ai-deliverability-agent-state.md): Get the live state of an AI Deliverability Agent: current activity, schedule, latest run summary, and the activity feed.
- [List AI Deliverability Agent feed items](https://developer.instantly.ai/api-reference/aideliverabilityagent/list-ai-deliverability-agent-feed-items.md): List the activity-feed items of an AI Deliverability Agent, newest first.
- [List company-list recipes](https://developer.instantly.ai/api-reference/companylist/list-company-list-recipes.md): Requires one of the following scopes: `supersearch_enrichments:read`, `supersearch_enrichments:all`, `all:read`, `all:all`
- [List company-list sources](https://developer.instantly.ai/api-reference/companylist/list-company-list-sources.md): Requires one of the following scopes: `supersearch_enrichments:read`, `supersearch_enrichments:all`, `all:read`, `all:all`
- [Get remote filter options for a catalog-backed company-list filter](https://developer.instantly.ai/api-reference/companylist/get-remote-filter-options-for-a-catalog-backed-company-list-filter.md): Requires one of the following scopes: `supersearch_enrichments:read`, `supersearch_enrichments:all`, `all:read`, `all:all`
- [List company lists](https://developer.instantly.ai/api-reference/companylist/list-company-lists.md): Requires one of the following scopes: `supersearch_enrichments:read`, `supersearch_enrichments:all`, `all:read`, `all:all`
- [Create a company list build](https://developer.instantly.ai/api-reference/companylist/create-a-company-list-build.md): Requires one of the following scopes: `supersearch_enrichments:create`, `supersearch_enrichments:all`, `all:create`, `all:all`
- [Get company-list status](https://developer.instantly.ai/api-reference/companylist/get-company-list-status.md): Requires one of the following scopes: `supersearch_enrichments:read`, `supersearch_enrichments:all`, `all:read`, `all:all`
- [Delete a terminal company list](https://developer.instantly.ai/api-reference/companylist/delete-a-terminal-company-list.md): Requires one of the following scopes: `supersearch_enrichments:delete`, `supersearch_enrichments:all`, `all:delete`, `all:all`
- [Rename a terminal company list](https://developer.instantly.ai/api-reference/companylist/rename-a-terminal-company-list.md): Requires one of the following scopes: `supersearch_enrichments:update`, `supersearch_enrichments:all`, `all:update`, `all:all`
- [List company-list members](https://developer.instantly.ai/api-reference/companylist/list-company-list-members.md): Requires one of the following scopes: `supersearch_enrichments:read`, `supersearch_enrichments:all`, `all:read`, `all:all`
- [Schemas](https://developer.instantly.ai/api-reference/schemas/index.md): Browse all API data models and their field definitions.
- [Introduction](https://developer.instantly.ai/sdk/introduction.md): Use the official Instantly TypeScript SDK to build API v2 integrations.
- [Quickstart](https://developer.instantly.ai/sdk/quickstart.md): Install the Instantly TypeScript SDK and make your first API request.
- [Introduction](https://developer.instantly.ai/cli/introduction.md): Manage and automate Instantly from your terminal with the official CLI.
- [Quickstart](https://developer.instantly.ai/cli/quickstart.md): Install the Instantly CLI, authenticate, and run your first command.
- [Introduction](https://developer.instantly.ai/mcp/introduction.md): Connect AI assistants to the Instantly API with the Model Context Protocol.
- [Quickstart](https://developer.instantly.ai/mcp/quickstart.md): Connect your AI assistant to the Instantly MCP server in a few minutes.
- [Authentication](https://developer.instantly.ai/mcp/authentication.md): Authenticate with the Instantly MCP server using headers or URL paths.
- [Available tools](https://developer.instantly.ai/mcp/tools.md): Browse the tools the Instantly MCP server exposes.

## OpenAPI Specs

- [api_v2](https://api.instantly.ai/openapi/api_v2.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.