Documentation
Messages that wait for a person to approve them.
A draft is a message, InMail, or connection request with a note that is not sent until someone in the workspace approves it. It goes from one connected account to one lead, so it belongs to that conversation.
{{variables}} are not filled in.A conversation has one API draft waiting at a time: creating another discards the waiting one as superseded. A campaign draft waits alongside it.
Members with access to the connected account review drafts in the inbox. The Drafts filter and the count next to Inbox in the sidebar show the conversations with one waiting. A reviewer can:
Approving is only possible in the app, so a person always decides what is sent. If an approved API draft fails to send, it goes back to review with the error.
Before anyone reviews it, the API can withdraw a draft it created.
A draft is awaiting_review, then sending once approved, and finally sent, failed, or discarded. A discarded draft has a discardReason: rejected, superseded, withdrawn, enrollment_stopped, campaign_archived, or task_cancelled.
Every draft records draft_created, draft_approved, draft_discarded, and draft_failed events. An approval records whether the reviewer edited the text and, if so, the original text. The sent message event carries the draftId and the member who approved it.
Search documentation, API reference, and MCP tools
We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy