POST
Save the caller's outbound send draft

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
session_id
string<uuid>
required

Send-capable session id this draft belongs to. A caller can create multiple drafts for the same session.

group_ids
string<uuid>[]

Internal group ids from /v2/groups that are present in the selected session. May be empty while composing.

Maximum array length: 100
text
string

Draft text body, or image caption when media is present.

Maximum string length: 4096
media
object[]

Already-uploaded image media URLs to keep with the draft. Multipart local files are not accepted by draft saves.

Maximum array length: 10
schedule
object
Example:

Response

Draft saved.

id
string<uuid>
required
actor_user_id
string
required

Clerk user id that owns this draft. Only this actor can read or delete it.

session_id
string<uuid>
required
session_name
string
required
session_label
string
required
group_ids
string<uuid>[]
required
text
string
required
media
object[]
required
created_at_ms
integer<int64>
required
updated_at_ms
integer<int64>
required
schedule
object
Example: