Mailboxes

Draft a message with AI

Ask Sendly's assistant to write a message for a mailbox — a new email from a short brief, a rewrite of something you already have, or a set of subject lines.

It returns text and sends nothing. The response always reports sent: false, and there is no argument that changes that. Putting a draft in someone's inbox is a separate operation (sendMailboxMessage) under a separate scope, so a client that may draft is not thereby a client that may mail your customers.

That is also why this operation asks only for mailboxes:read: it names a mailbox so the draft can be written in that address's voice, reads no correspondence, and stores nothing.

Everything you pass — the brief, the draft, the recipient context — is treated strictly as data describing what to write, never as instructions to the model.

Drafting is capped at 120 requests per hour per project.

Requires the mailboxes:read scope — View the mailboxes on your domains and their settings.

post/api/mailboxes/{id}/drafts

Request

  • Base URL: https://api.sendly.now
  • URL: https://api.sendly.now/api/mailboxes/{id}/drafts
  • Auth: one of:
    • HTTP bearer
    • API key in cookie better-auth.session_token
    • OAuth 2 (authorization code, authorization URL https://app.sendly.now/api/auth/oauth2/authorize, token URL https://app.sendly.now/api/auth/oauth2/token, scopes: mailboxes:read)

Path parameters

idstring uuid required

Request body

briefstring
draftstring
instructionstring
mode'draft' | 'rewrite' | 'subject' required
recipientContextstring
senderAddressstring
tone'friendly' | 'neutral' | 'formal' | 'apologetic' | 'direct'

Response

A draft. Nothing was sent.

successtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.