INinstantly
InboxPlacementTest

Get inbox placement test

Requires one of the following scopes: inbox_placement_tests:read, inbox_placement_tests:all, all:read, all:all

get/api/v2/inbox-placement-tests/{id}

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/inbox-placement-tests/{id}
  • Auth
    HTTP bearer

Path parameters

idstring uuid required
Example:01a19e6f-8d0e-7952-b4bb-ff3b1cfbe8e3

The ID of the requested item

Query parameters

with_metadataboolean
Example:true

Whether to include additional metadata about the inbox placement test

Response

The requested Inbox Placement Test

idstring uuid

Unique identifier for the inbox placement test

organization_idstring uuid

Organization ID

namestring

Name of the inbox placement test

delivery_mode1 | 2 | null nullable

Whether to send emails one by one or all together

descriptionstring nullable

Description of the inbox placement test

type1 | 2

Whether the inbox placement test is a one-time test or an automated test

sending_method1 | 2

Whether the inbox placement test will be sent from Instantly or from outside Instantly

campaign_idstring uuid nullable

Campaign ID

email_subjectstring

Email subject of the inbox placement test

email_bodystring

Email body of the inbox placement test

emailsstring[]

Emails to send the inbox placement test to

test_codestring nullable

Code for identifying inbox placement tests sent from outside Instantly. Use ptid_ followed by letters, numbers, hyphens, or underscores. When creating a test, the ptid_ prefix is added automatically if omitted. The full code must be at most 50 characters.

tagsstring[] nullable

List of tag IDs to use for sending emails

text_onlyboolean nullable

Disables open tracking

recipientsstring[]
timestamp_createdstring

Timestamp when the inbox placement test was created

timestamp_next_runstring nullable

Timestamp when the inbox placement test will run next

status1 | 2 | 3 nullable

Status of the inbox placement test

not_sending_status'daily_limits_hit' | 'other' nullable

Why the inbox placement test is currently not sending. It will be an empty string if there are no issues.

Example response

{
  "id": "01a19e6f-506e-7a4a-ab49-a2f9469182a4",
  "organization_id": "01a19e6f-506e-7a4a-ab49-a2fa87d9a620",
  "name": "My Inbox Placement Test",
  "delivery_mode": 1,
  "description": "This is a test description",
  "schedule": {
    "days": {
      "2": true,
      "3": true
    },
    "timing": {
      "from": "02:30"
    },
    "timezone": "America/Chihuahua"
  },
  "type": 1,
  "sending_method": 1,
  "campaign_id": "01a19e6f-506e-7a4a-ab49-a2fb93b255fa",
  "email_subject": "My Email Subject",
  "email_body": "Hi, this is my email body",
  "emails": [
    "john@doe.com"
  ],
  "test_code": "ptid_ZN5wE76zXbdaCCwVTzzfD",
  "tags": [
    "01a19e6f-506e-7a4a-ab49-a2fc412208c2"
  ],
  "text_only": true,
  "recipients": [
    "johndoe@instantly.ai"
  ],
  "recipients_labels": [
    {
      "region": "North America",
      "sub_region": "US",
      "type": "Professional",
      "esp": "Google"
    }
  ],
  "timestamp_created": "2026-11-02T22:44:17.646Z",
  "timestamp_next_run": "2026-11-02T22:44:17.646Z",
  "automations": [
    {
      "when": {
        "condition": "placement_goes_below",
        "condition_value": 80
      },
      "then": {
        "webhook_url": "https://example.com/webhook",
        "pause_sending_campaigns_for": 14,
        "pause": true,
        "enable_slow_ramp": true,
        "disable_slow_ramp": true,
        "add_tags": [
          "01a19e6f-506e-7a4a-ab49-a2fe97885f3d"
        ],
        "remove_tags": [
          "01a19e6f-506e-7a4a-ab49-a2ff858ced76"
        ]
      }
    }
  ],
  "status": 1,
  "not_sending_status": "daily_limits_hit",
  "metadata": {
    "campaign": {
      "id": "campaign-id",
      "name": "Campaign Name"
    },
    "tags": {
      "tag-id": {
        "id": "tag-id",
        "label": "Tag Label"
      }
    }
  }
}

Changes

No recorded changes to this operation across all 6 revisions of this API.