POST /api/v1.0/send — messages-api

admin-users-list1

blob3

calendar4

channels14

config1

contacts2

flags1

import6

labels7

mailbox-accesses6

mailboxes17

maildomain-accesses4

maildomains18

messages11

placeholders1

tasks1

third-party/drive2

thread-access5

thread-events7

thread-users1

threads8

users1

messages

Send a previously created draft message.

This endpoint finalizes and sends a message previously saved as a draft.
The message content (subject, body, recipients) should be set when creating/updating the draft.
Returns a task ID that can be used to track the sending status.

post/api/v1.0/send/

Request body

messageIdstring uuid required

senderIdstring uuid required

archiveboolean

textBodystring

htmlBodystring

Response

task_idstring uuid required

Task ID for tracking

Changes

Changed in 15 of the 54 revisions of this API.14626

Jun 13, 20269d5cc50423c312See the full diff
- ▲
  removed the required property message from the response with the 200 status
  response-required-property-removed
- ○
  added the non-success response with the status 500
  response-non-success-status-added
- ○
  removed the non-success response with the status 503
  response-non-success-status-removed
Apr 8, 2026bd878fae58721See the full diff
- ○
  added the required property message/mime_id to the response with the 200 status
  response-required-property-added
Mar 16, 202600a56b21a28b13See the full diff
- ●
  added the new autoreply enum value to the message/signature/allOf[ReadMessageTemplate]/type response property for the response status 200
  response-property-enum-value-added
- ○
  added the optional property message/signature/allOf[ReadMessageTemplate]/metadata to the response with the 200 status
  response-optional-property-added
- ○
  added the required property message/signature/allOf[ReadMessageTemplate]/is_active_autoreply to the response with the 200 status
  response-required-property-added
- ○
  added the required property message/signature/allOf[ReadMessageTemplate]/signature to the response with the 200 status
  response-required-property-added
Mar 10, 2026a5dc72b4835b211See the full diff
- ▲
  removed the required property message/signature/allOf[ReadMessageTemplate]/is_active_autoreply from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property message/signature/allOf[ReadMessageTemplate]/signature from the response with the 200 status
  response-required-property-removed
- ●
  removed the optional property message/signature/allOf[ReadMessageTemplate]/metadata from the response with the 200 status
  response-optional-property-removed
- ○
  removed the autoreply enum value from the message/signature/allOf[ReadMessageTemplate]/type response property for the response status 200
  response-property-enum-value-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 9, 202605988c44471013See the full diff
- ●
  added the new autoreply enum value to the message/signature/allOf[ReadMessageTemplate]/type response property for the response status 200
  response-property-enum-value-added
- ○
  added the optional property message/signature/allOf[ReadMessageTemplate]/metadata to the response with the 200 status
  response-optional-property-added
- ○
  added the required property message/signature/allOf[ReadMessageTemplate]/is_active_autoreply to the response with the 200 status
  response-required-property-added
- ○
  added the required property message/signature/allOf[ReadMessageTemplate]/signature to the response with the 200 status
  response-required-property-added
Mar 3, 202695d67b78149c2See the full diff
- ▲
  removed the required property message/is_starred from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property message/read_at from the response with the 200 status
  response-required-property-removed
Mar 3, 202616cddb16df6f1See the full diff
- ○
  added the required property message/sender_user to the response with the 200 status
  response-required-property-added
Mar 3, 2026e6feb47a0d7e11See the full diff
- ▲
  removed the required property message/sender_user from the response with the 200 status
  response-required-property-removed
- ○
  added the required property message/read_at to the response with the 200 status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 25, 2026575958bae45911See the full diff
- ▲
  removed the required property message/read_at from the response with the 200 status
  response-required-property-removed
- ○
  added the required property message/sender_user to the response with the 200 status
  response-required-property-added
Feb 18, 20268217fec7be4b2See the full diff
- ○
  added ReadMessageTemplate to the message/signature response property allOf list for the response status 200
  response-property-all-of-added
- ○
  removed ReadOnlyMessageTemplate from the message/signature response property allOf list for the response status 200
  response-property-all-of-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history (15 revisions)