Block List Entry

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.

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

Operations

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 items

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

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

Schemas

Custom Tag

A custom tag for organizing and categorizing items

idstring(uuid)read-onlyrequired

Unique identifier for the custom tag

Example: "01967c97-63dd-77f8-97d4-c7f32bd4c7a1"

timestamp_createdstring(date-time)read-onlyrequired

Timestamp when the custom tag was created

Example: "2025-04-28T13:30:18.461Z"

timestamp_updatedstring(date-time)read-onlyrequired

Timestamp when the custom tag was last updated

Example: "2025-04-28T13:30:18.461Z"

organization_idstring(uuid)read-onlyrequired

Organization ID that owns this custom tag

Example: "01967c97-63dd-77f8-97d4-c7f437445ceb"

labelstringrequired

Display label for the custom tag

Example: "Important"

descriptionstring

Detailed description of the custom tag purpose

Example: "Used for marking important items"

{
  "id": "01967c97-63dd-77f8-97d4-c7f32bd4c7a1",
  "timestamp_created": "2025-04-28T13:30:18.461Z",
  "timestamp_updated": "2025-04-28T13:30:18.461Z",
  "organization_id": "01967c97-63dd-77f8-97d4-c7f437445ceb",
  "label": "Important",
  "description": "Used for marking important items"
}

Block List Entry

A blocked email or domain

idstring(uuid)read-onlyrequired

Unique identifier for the block list entry

Example: "01967c97-63e1-7e8f-98ce-e988f70fc6da"

timestamp_createdstring(date-time)read-onlyrequired

Timestamp when the block list entry was created

Example: "2025-04-28T13:30:18.465Z"

organization_idstring(uuid)read-onlyrequired

Organization ID that owns this block list entry

Example: "01967c97-63e1-7e8f-98ce-e989c5b51a9c"

bl_valuestringrequired

The email or domain to block

Example: "example.com"

is_domainbooleanread-onlyrequired

Whether this entry blocks an entire domain

Example: true

{
  "id": "01967c97-63e1-7e8f-98ce-e988f70fc6da",
  "timestamp_created": "2025-04-28T13:30:18.465Z",
  "organization_id": "01967c97-63e1-7e8f-98ce-e989c5b51a9c",
  "bl_value": "example.com",
  "is_domain": true
}

Lead Label

A custom label for categorizing and managing leads

idstring(uuid)read-onlyrequired

Unique identifier for the custom lead label

Example: "01967c97-63e4-7c96-9013-68023d43be18"

timestamp_createdstring(date-time)read-onlyrequired

Timestamp when the custom lead label was created

Example: "2025-04-28T13:30:18.468Z"

created_bystring(uuid)read-onlyrequired

User ID of the creator of this label

Example: "01967c97-63e4-7c96-9013-6803a8427d1f"

organization_idstring(uuid)read-onlyrequired

Organization ID that owns this custom lead label

Example: "01967c97-63e4-7c96-9013-6804e764773a"

labelstringrequired

Display label for the custom lead label

Example: "Hot Lead"

interest_status_labelstringrequired

Interest status label associated with this label

Enum Value	Description
positive	Positive
negative	Negative
neutral	Neutral

Example: "positive"

interest_statusnumberread-onlyrequired

Interest status associated with this label. This is generated automatically by us.

Example: 1

descriptionstring

Detailed description of the custom lead label purpose

Example: "Used for marking high-priority leads"

use_with_aiboolean

Whether this label should be used with AI features

Example: false

{
  "id": "01967c97-63e4-7c96-9013-68023d43be18",
  "timestamp_created": "2025-04-28T13:30:18.468Z",
  "created_by": "01967c97-63e4-7c96-9013-6803a8427d1f",
  "organization_id": "01967c97-63e4-7c96-9013-6804e764773a",
  "label": "Hot Lead",
  "interest_status_label": "positive",
  "interest_status": 1,
  "description": "Used for marking high-priority leads",
  "use_with_ai": false
}