inbox.draft.created

{
  "type": "inbox.draft.created",
  "created_at": "2026-09-29T12:00:00.000Z",
  "data": {
    "source": "api",
    "inbox_id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
    "thread_id": "7c1f0a2e-5d3b-4e8a-9f61-2b8d4c6e1a90",
    "draft_id": "9a2b7c4d-1e3f-4a5b-8c6d-0e1f2a3b4c5d",
    "thread": {
      "object": "inbox_thread",
      "id": "7c1f0a2e-5d3b-4e8a-9f61-2b8d4c6e1a90",
      "subject": "Question about my invoice",
      "folder": "inbox",
      "labels": [],
      "read": false
    },
    "draft": {
      "object": "inbox_draft",
      "id": "9a2b7c4d-1e3f-4a5b-8c6d-0e1f2a3b4c5d",
      "type": "reply",
      "to": ["steve.wozniak@gmail.com"],
      "cc": [],
      "bcc": [],
      "subject": "Re: Question about my invoice",
      "thread_id": "7c1f0a2e-5d3b-4e8a-9f61-2b8d4c6e1a90",
      "reply_to_email_id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",
      "email_id": null,
      "created_at": "2026-09-29T11:58:00.000Z",
      "updated_at": "2026-09-29T12:00:00.000Z",
      "attachments": []
    }
  }
}

Event triggered whenever a draft is created, standalone or reply.

Response Body Parameters

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

string

The event type that triggered the webhook (e.g., inbox.draft.created).

string

ISO 8601 timestamp when the webhook event was created.

object

Event-specific data containing detailed information about the event. The data object for the inbox.draft.created event contains the following parameters:

Hide object parameters

api | dashboard | agent | system

What made the change

string

The ID of the inbox

string

The ID of the thread. Only on reply drafts

string

The ID of the draft

object

The thread, as it is when the webhook is sent. Absent when the thread no longer exists. Only on reply drafts

Hide thread object

string

Always inbox_thread

string

The ID of the thread

string | null

The subject of the thread

inbox | archive | spam | sent | trash

The folder the thread lives in

array

The labels attached to the thread, each with an id, name, and color

boolean

True only when every message in the thread is read

object

The draft, as it is when the webhook is sent, without html or text. Fetch the body with Retrieve Draft. Absent when the draft no longer exists

Hide draft object

string

Always inbox_draft

string

The ID of the draft

standalone | reply

standalone for a new conversation, or reply

string[] | null

Recipients

string[]

CC recipients

string[]

BCC recipients

string | null

The subject

string | null

The Thread ID when this draft is a reply. null otherwise

string | null

The Email ID being replied to. null otherwise

string | null

The queued outbound email after send. null until then

string

ISO 8601 timestamp when the draft was created

string

ISO 8601 timestamp when the draft was last saved

array

The files stored on the draft

Hide attachment object

string

The ID of the attachment

string

The filename of the attachment

string

The MIME type of the attachment

number

The size of the attachment in bytes

{
  "type": "inbox.draft.created",
  "created_at": "2026-09-29T12:00:00.000Z",
  "data": {
    "source": "api",
    "inbox_id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
    "thread_id": "7c1f0a2e-5d3b-4e8a-9f61-2b8d4c6e1a90",
    "draft_id": "9a2b7c4d-1e3f-4a5b-8c6d-0e1f2a3b4c5d",
    "thread": {
      "object": "inbox_thread",
      "id": "7c1f0a2e-5d3b-4e8a-9f61-2b8d4c6e1a90",
      "subject": "Question about my invoice",
      "folder": "inbox",
      "labels": [],
      "read": false
    },
    "draft": {
      "object": "inbox_draft",
      "id": "9a2b7c4d-1e3f-4a5b-8c6d-0e1f2a3b4c5d",
      "type": "reply",
      "to": ["steve.wozniak@gmail.com"],
      "cc": [],
      "bcc": [],
      "subject": "Re: Question about my invoice",
      "thread_id": "7c1f0a2e-5d3b-4e8a-9f61-2b8d4c6e1a90",
      "reply_to_email_id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",
      "email_id": null,
      "created_at": "2026-09-29T11:58:00.000Z",
      "updated_at": "2026-09-29T12:00:00.000Z",
      "attachments": []
    }
  }
}

⌘I

{
  "type": "inbox.draft.created",
  "created_at": "2026-09-29T12:00:00.000Z",
  "data": {
    "source": "api",
    "inbox_id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
    "thread_id": "7c1f0a2e-5d3b-4e8a-9f61-2b8d4c6e1a90",
    "draft_id": "9a2b7c4d-1e3f-4a5b-8c6d-0e1f2a3b4c5d",
    "thread": {
      "object": "inbox_thread",
      "id": "7c1f0a2e-5d3b-4e8a-9f61-2b8d4c6e1a90",
      "subject": "Question about my invoice",
      "folder": "inbox",
      "labels": [],
      "read": false
    },
    "draft": {
      "object": "inbox_draft",
      "id": "9a2b7c4d-1e3f-4a5b-8c6d-0e1f2a3b4c5d",
      "type": "reply",
      "to": ["steve.wozniak@gmail.com"],
      "cc": [],
      "bcc": [],
      "subject": "Re: Question about my invoice",
      "thread_id": "7c1f0a2e-5d3b-4e8a-9f61-2b8d4c6e1a90",
      "reply_to_email_id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",
      "email_id": null,
      "created_at": "2026-09-29T11:58:00.000Z",
      "updated_at": "2026-09-29T12:00:00.000Z",
      "attachments": []
    }
  }
}

Get started

Learn

Resources

inbox.draft.created

Response Body Parameters