WarmablyWarmablyDOCS
Search docs⌘K
Dashboard
API Reference/Endpoints

Create a draft

POST/api/linkedin/gateway/drafts

Saves an unsent email as a draft in the connected mailbox, for the account holder to review or send later from their own mail client.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.

Body parameters

FieldTypeDescription
account_id *stringThe mailbox to save the draft in.
to *arrayRecipients: { identifier, display_name? } each.
body *stringThe draft's content, as HTML.
subjectstringThe draft's subject line.
fromobjectOverrides the sending identity, when the mailbox has more than one.
ccarraySame shape as to.
bccarraySame shape as to.
reply_tostringThe id (Warmably or provider) of an email this draft replies to.
custom_headersarrayExtra headers, { name, value } each, restricted the same way as on Send an email.
tracking_optionsobjectOpen/click tracking config, applied once the draft is eventually sent.
Warmably's gateway currently only forwards JSON request bodies. The underlying draft endpoint also accepts an attachments field for binary file uploads, but that field isn't usable through this route yet.

Response fields

FieldTypeDescription
object"DraftCreated"Always this value.
draft_idstringThe new draft's id.

Errors

·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. The account_id doesn't belong to this key.
CredentialsRequired
AuthorizationBearer wm_live_••••••••
RequestTry it
curl -X POST https://api.warmably.com/api/linkedin/gateway/drafts \
  -H "Authorization: Bearer wm_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "459993d2-b0e7-4b19-baf9-45252ca324cf",
    "to": [{ "identifier": "priya@example.com" }],
    "subject": "Draft: proposal follow-up",
    "body": "<p>Wanted to check in on the proposal we sent last week.</p>"
  }'
Response
200 OK
{
  "object": "DraftCreated",
  "draft_id": "d_2f8b41c9"
}
No key yet? Create one from Dashboard → API Keys.