Schemas
/
Account Campaign Mapping

API Explorer (2.0.0)

The entire API V2 documentation is interactive and can be tested here. To the right side of every endpoint you will see a box with an example request. You can click on the "Try it" button to send a request to the server right from the docs. You will need to provide an API key by clicking the ApiKeyAuth_token blue text.

Languages
Servers
Instantly API Server

https://api.instantly.ai/

Mock server

https://developer.instantly.ai/_mock/api/v2/

Analytics

Endpoints related to analytics

Operations

Account

An email account that can be used to send campaigns

Operations

Campaign

A campaign that can be sent to a list of recipients

Operations

Email

A campaign email, a reply, a manually sent email, or any other email that's visible in the Unibox

Operations

Email Verification

A single email verification

Operations

Lead List

A list used to store leads

Operations

Inbox Placement Test

An inbox placement test

Operations

Inbox Placement Analytics

Analytics data for individual emails in inbox placement tests

Operations

Inbox Placement Blacklist & SpamAssassin Report

Report data for an inbox placement test

Operations

API Key

API Key

Operations

Account Campaign Mapping

Account Campaign Mapping

Operations

Lead

A lead entity representing an individual lead

Operations

Background Job

A background job that can be used to perform long-running tasks

Operations

Custom Tag

A custom tag for organizing and categorizing accounts and campaigns. You can use them as filters in apis that list accounts and campaigns.

Operations

Custom Tag Mapping

This entity represents a tag being assigned to a specific campaign or email account. When an email account is assigned a tag, a new custom tag mapping entry is created, which connects the tag (tag_id field) with the email account (resource_id field). You can use it to see which tag si connected to which resource.

Operations

Block List Entry

A blocked email or domain

Operations

Lead Label

A custom label for categorizing and managing leads

Operations

Workspace

A workspace entity representing a workspace

Operations

SuperSearch Enrichment

An enrichment can take different forms, such as email enrichment or LinkedIn enrichment. Leads may be imported from SuperSearch using the dedicated endpoint, or enriched directly within a list or campaign by attaching an enrichment to it.

Operations

Workspace Group Member

A member of a workspace group. You can use the endpoints within this entity to manage the members of a workspace group.

Operations

Workspace Member

A member of a workspace with associated user details

Operations

Campaign Subsequence

A subsequence entity representing a follow-up sequence

Operations

Audit Log

Audit log records for tracking system activities

Operations

Webhook

A webhook subscription for receiving event notifications

Operations

Webhook Event

A webhook event that was sent or attempted to be sent

Operations

DFY Email Account Order

A Done-For-You email account order

Operations

Custom Prompt Template

Custom prompt templates for creating custom prompts

Sales Flow

Manages how sales users view and interact with campaign and lead lists within the sales flow.

Email Template

A campaign email template

Workspace Billing

Workspace Billing

Operations

CRM Actions

CRM related actions

Operations

Schemas

API Key

API Key

idstring(uuid)read-onlyrequired
Example: "019b21c4-6864-74aa-9a48-81472037f020"
namestringrequired
Example: "My API Key"
scopesArray of stringsrequired
Items Enum"all:all""all:create""all:read""all:update""all:delete""ai_agents:all""ai_agents:create""ai_agents:read""ai_agents:update""ai_agents:delete"
Example: ["campaigns:create"]
keystringread-onlyrequired
Example: "a1b2c3d4e5f6g7h8i9j0"
organization_idstring(uuid)read-onlyrequired
Example: "019b21c4-6873-72a1-bb0d-1e177b2eed53"
timestamp_createdstring(date-time)read-onlyrequired
Example: "2025-12-15T11:27:58.579Z"
timestamp_updatedstring(date-time)read-onlyrequired
Example: "2025-12-15T11:27:58.579Z"
{
  "id": "019b21c4-6864-74aa-9a48-81472037f020",
  "name": "My API Key",
  "scopes": [
    "campaigns:create"
  ],
  "key": "a1b2c3d4e5f6g7h8i9j0",
  "organization_id": "019b21c4-6873-72a1-bb0d-1e177b2eed53",
  "timestamp_created": "2025-12-15T11:27:58.579Z",
  "timestamp_updated": "2025-12-15T11:27:58.579Z"
}

Account Campaign Mapping

Account Campaign Mapping

campaign_idstring(uuid)required
Example: "019b21c4-6863-7a99-846a-5f02d37c3fca"
campaign_namestringrequired
Example: "Campaign Name"
timestamp_createdstringread-onlyrequired

Timestamp when the campaign was created

Example: "2025-12-15T11:27:58.563Z"
statusnumber

Campaign Status

Enum ValueDescription
0

Draft

1

Active

2

Paused

3

Completed

4

Running Subsequences

-99

Account Suspended

-1

Accounts Unhealthy

-2

Bounce Protect

Example: 1
{
  "campaign_id": "019b21c4-6863-7a99-846a-5f02d37c3fca",
  "campaign_name": "Campaign Name",
  "timestamp_created": "2025-12-15T11:27:58.563Z",
  "status": 1
}

Lead

A lead entity representing an individual lead

idstring(uuid)read-onlyrequired

Unique identifier for the lead

Example: "019b21c4-5e4e-702b-94cd-3af66e65d0ec"
timestamp_createdstring(date-time)read-onlyrequired

Timestamp when the lead was created

Example: "2025-12-15T11:27:55.984Z"
timestamp_updatedstring(date-time)read-onlyrequired

Timestamp when the lead was last updated

Example: "2025-12-15T11:27:55.984Z"
organizationstring(uuid)read-onlyrequired

Organization ID associated with the lead

Example: "019b21c4-5e50-79cf-8ecc-c2a1f0f698b1"
statusnumberread-onlyrequired

Status of the lead

Enum ValueDescription
1

Active

2

Paused

3

Completed

-1

Bounced

-2

Unsubscribed

-3

Skipped

Example: 1
email_open_countnumberread-onlyrequired

Number of times the email was opened

Example: 0
email_reply_countnumberread-onlyrequired

Number of times the email was replied to

Example: 0
email_click_countnumberread-onlyrequired

Number of times the email was clicked

Example: 0
company_domainstringread-onlyrequired

Company domain of the lead

Example: "example.com"
status_summaryobjectread-onlyrequired

Status summary of the lead

status_summary.​lastStepobject
status_summary.​domain_completeboolean
Example: true
campaignnull or string(uuid)

Campaign ID associated with the lead

Example: "019b21c4-5e50-79cf-8ecc-c2a21429d5bd"
emailnull or string

Email address of the lead

Example: "example@example.com"
personalizationnull or string

Personalization of the lead

Example: "Hello, how are you?"
websitenull or string

Website of the lead

Example: "https://example.com"
last_namenull or string

Last name of the lead

Example: "Doe"
first_namenull or string

First name of the lead

Example: "John"
company_namenull or string

Company name of the lead

Example: "Example Inc."
phonenull or string

Phone number of the lead

Example: "+1234567890"
payloadnull or objectread-only

Lead custom variables. This object can contain any key, but the values have to be of type string, number, boolean, or null. We do NOT allow objects or arrays as values.

status_summary_subseqobjectread-only

Subsequence status summary of the lead

last_step_fromnull or stringread-only

Source of the last step

Example: "campaign"
last_step_idnull or string(uuid)read-only

ID of the last step

Example: "019b21c4-5e51-7373-9aff-d11da7581322"
last_step_timestamp_executednull or string(date-time)read-only

Timestamp when the last step was executed

Example: "2025-12-15T11:27:55.985Z"
email_opened_stepnull or numberread-only

Last email step opened by the lead

Example: 1
email_opened_variantnull or numberread-only

Last step variant opened by the lead

Example: 1
email_replied_stepnull or numberread-only

Last email step the lead has replied to

Example: 1
email_replied_variantnull or numberread-only

Last step variant the lead has replied to

Example: 1
email_clicked_stepnull or numberread-only

Last email step the lead has clicked

Example: 1
email_clicked_variantnull or numberread-only

Last step variant the lead has clicked

Example: 1
lt_interest_statusnumber

Lead interest status. It can be either a static value (check below), or a custom status interest value

Enum ValueDescription
0

Out of Office

1

Interested

2

Meeting Booked

3

Meeting Completed

4

Closed

-1

Not Interested

-2

Wrong Person

-3

Lost

Example: 1
subsequence_idnull or stringread-only

ID of the subsequence

Example: "019b21c4-5e51-7373-9aff-d11e2674127d"
verification_statusnumberread-only

Verification status of the lead

Enum ValueDescription
1

Verified

11

Pending

12

Pending Verification Job

-1

Invalid

-2

Risky

-3

Catch All

-4

Job Change

Example: 1
pl_value_leadnull or string

Potential value of the lead

Example: "High"
timestamp_added_subsequencenull or string(date-time)read-only

Timestamp when the lead was added to the subsequence

Example: "2025-12-15T11:27:55.985Z"
timestamp_last_contactnull or string(date-time)read-only

Timestamp of the last contact with the lead

Example: "2025-12-15T11:27:55.985Z"
timestamp_last_opennull or string(date-time)read-only

Timestamp of the last email open

Example: "2025-12-15T11:27:55.985Z"
timestamp_last_replynull or string(date-time)read-only

Timestamp of the last email reply

Example: "2025-12-15T11:27:55.985Z"
timestamp_last_interest_changenull or string(date-time)read-only

Timestamp of the last interest status change

Example: "2025-12-15T11:27:55.985Z"
timestamp_last_clicknull or string(date-time)read-only

Timestamp of the last email click

Example: "2025-12-15T11:27:55.985Z"
enrichment_statusnumberread-only

Enrichment status of the lead

Enum ValueDescription
1

Enriched

11

Pending

-1

Enrichment data not available

-2

Error

Example: 1
list_idnull or string(uuid)

List ID associated with the lead

Example: "019b21c4-5e51-7373-9aff-d11f80ca250a"
last_contacted_fromnull or stringread-only

Source of the last contact

Example: "email"
uploaded_by_usernull or string(uuid)read-only

ID of the user who uploaded the lead

Example: "019b21c4-5e51-7373-9aff-d1205b780012"
upload_methodstringread-only

Method used to upload the lead

Enum ValueDescription
manual

Manual

api

API

website-visitor

Website Visitor

Example: "manual"
assigned_tonull or string(uuid)

ID of the user assigned to the lead

Example: "019b21c4-5e51-7373-9aff-d121f44b49e2"
is_website_visitornull or booleanread-only

Indicates if the lead is a website visitor

Example: true
timestamp_last_touchnull or string(date-time)read-only

Timestamp of the last touch with the lead

Example: "2025-12-15T11:27:55.985Z"
esp_codenumberread-only

ESP code associated with the lead

Enum ValueDescription
0

In Queue

1

Google

2

Microsoft

3

Zoho

9

Yahoo

10

Yandex

12

Web.de

13

Libero.it

999

Other

1000

Not Found

Example: 1
esg_codenumberread-only

ESG code associated with the lead

Enum ValueDescription
0

In Queue

1

Barracuda

2

Mimecast

3

Proofpoint

4

Cisco

Example: 1
{
  "id": "019b21c4-5e4e-702b-94cd-3af66e65d0ec",
  "timestamp_created": "2025-12-15T11:27:55.984Z",
  "timestamp_updated": "2025-12-15T11:27:55.984Z",
  "organization": "019b21c4-5e50-79cf-8ecc-c2a1f0f698b1",
  "campaign": "019b21c4-5e50-79cf-8ecc-c2a21429d5bd",
  "status": 1,
  "email": "example@example.com",
  "personalization": "Hello, how are you?",
  "website": "https://example.com",
  "last_name": "Doe",
  "first_name": "John",
  "company_name": "Example Inc.",
  "phone": "+1234567890",
  "email_open_count": 0,
  "email_reply_count": 0,
  "email_click_count": 0,
  "company_domain": "example.com",
  "status_summary": {
    "lastStep": { … },
    "domain_complete": true
  },
  "payload": null,
  "status_summary_subseq": {
    "from": "campaign",
    "stepID": "019b21c4-5e51-7373-9aff-d11c5002a9a9",
    "timestampExecuted": "2025-12-15T11:27:55.985Z"
  },
  "last_step_from": "campaign",
  "last_step_id": "019b21c4-5e51-7373-9aff-d11da7581322",
  "last_step_timestamp_executed": "2025-12-15T11:27:55.985Z",
  "email_opened_step": 1,
  "email_opened_variant": 1,
  "email_replied_step": 1,
  "email_replied_variant": 1,
  "email_clicked_step": 1,
  "email_clicked_variant": 1,
  "lt_interest_status": 1,
  "subsequence_id": "019b21c4-5e51-7373-9aff-d11e2674127d",
  "verification_status": 1,
  "pl_value_lead": "High",
  "timestamp_added_subsequence": "2025-12-15T11:27:55.985Z",
  "timestamp_last_contact": "2025-12-15T11:27:55.985Z",
  "timestamp_last_open": "2025-12-15T11:27:55.985Z",
  "timestamp_last_reply": "2025-12-15T11:27:55.985Z",
  "timestamp_last_interest_change": "2025-12-15T11:27:55.985Z",
  "timestamp_last_click": "2025-12-15T11:27:55.985Z",
  "enrichment_status": 1,
  "list_id": "019b21c4-5e51-7373-9aff-d11f80ca250a",
  "last_contacted_from": "email",
  "uploaded_by_user": "019b21c4-5e51-7373-9aff-d1205b780012",
  "upload_method": "manual",
  "assigned_to": "019b21c4-5e51-7373-9aff-d121f44b49e2",
  "is_website_visitor": true,
  "timestamp_last_touch": "2025-12-15T11:27:55.985Z",
  "esp_code": 1,
  "esg_code": 1
}