--- title: "Changes to Create or send an email message" method: POST path: "/email_messages" --- # Changes to Create or send an email message `POST /email_messages` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 7 of 61 revisions. - **2026-07-28** `b1bf96d8391e` — 1 breaking, 3 warning, 17 info - **2026-07-21** `80833e66e010` — 1 breaking - **2026-07-16** `2fb3b617430a` — 16 warning, 9 info - **2026-07-14** `021f0faf96df` — 1 breaking, 1 warning - **2026-07-12** `b3c5aebde44c` — 2 breaking, 13 warning, 3 info - **2026-07-07** `6ef0ae248bf7` — 1 info - **2026-07-02** `224ed0d8a5c3` — 1 breaking ## Changes - **2026-07-28** `b1bf96d8391e` — 1 breaking, 3 warning, 17 info - removed the required property `data/inserted_at` from the response with the `202` status - removed the optional property `data/send_at` from the response with the `202` status - removed the optional property `data/suppressed` from the response with the `202` status - added the new `daily_limit_exceeded` enum value to the `data/events/items/type` response property for the response status `202` - added the new optional request property `attachments/items/content_id` - added the new optional request property `attachments/items/disposition` - added the new optional request property `forward_of_message_id` - added the new optional request property `in_reply_to_message_id` - added the new optional request property `reply_to_all` - added the new optional request property `scheduled_at` - added the new optional request property `tracking_settings` - the request property `group_id` became nullable - request property `send_at` deprecated - added the optional property `data/recipient_statuses` to the response with the `202` status - added the optional property `data/scheduled_at` to the response with the `202` status - added the required property `data/attachments/items/content_id` to the response with the `202` status - added the required property `data/attachments/items/disposition` to the response with the `202` status - added the required property `data/attachments/items/sha256` to the response with the `202` status - added the required property `data/attachments/items/size_bytes` to the response with the `202` status - added the required property `data/attachments/items/url` to the response with the `202` status - added the required property `data/created_at` to the response with the `202` status - **2026-07-21** `80833e66e010` — 1 breaking - added `#/components/schemas/RenderErrorResponse` to the response body `oneOf` list for the response status `422` - **2026-07-16** `2fb3b617430a` — 16 warning, 9 info - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `400` - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `401` - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `403` - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `404` - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `409` - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `413` - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `503` - added the new `recipient_suppressed` enum value to the `oneOf[#/components/schemas/email_ErrorResponse]/errors/items/code` response property for the response status `422` - added the new `reputation_suspended` enum value to the `errors/items/code` response property for the response status `400` - added the new `reputation_suspended` enum value to the `errors/items/code` response property for the response status `401` - added the new `reputation_suspended` enum value to the `errors/items/code` response property for the response status `403` - added the new `reputation_suspended` enum value to the `errors/items/code` response property for the response status `404` - added the new `reputation_suspended` enum value to the `errors/items/code` response property for the response status `409` - added the new `reputation_suspended` enum value to the `errors/items/code` response property for the response status `413` - added the new `reputation_suspended` enum value to the `errors/items/code` response property for the response status `503` - added the new `reputation_suspended` enum value to the `oneOf[#/components/schemas/email_ErrorResponse]/errors/items/code` response property for the response status `422` - added the optional property `oneOf[#/components/schemas/email_ErrorResponse]/suppressed` to the response with the `422` status - added the optional property `suppressed` to the response with the `202` status - added the optional property `suppressed` to the response with the `400` status - added the optional property `suppressed` to the response with the `401` status - added the optional property `suppressed` to the response with the `403` status - added the optional property `suppressed` to the response with the `404` status - added the optional property `suppressed` to the response with the `409` status - added the optional property `suppressed` to the response with the `413` status - added the optional property `suppressed` to the response with the `503` status - **2026-07-14** `021f0faf96df` — 1 breaking, 1 warning - for the `header` request parameter `Idempotency-Key`, the maxLength was decreased from `512` to `255` - changed the pattern of the `header` request parameter `Idempotency-Key` from `^(?:[A-Za-z0-9_-]{1,255}|"(?:[\x20-\x21\x23-\x5B\x5D-\x7E]|\\["\\]){1,255}")$` to `^[A-Za-z0-9_-]{1,255}$` - **2026-07-12** `b3c5aebde44c` — 2 breaking, 13 warning, 3 info - removed the required property `data/idempotency_key` from the response with the `202` status - removed the success response with the status `200` - removed the request property `idempotency_key` - added the new `10027` enum value to the `errors/items/code` response property for the response status `400` - added the new `10027` enum value to the `errors/items/code` response property for the response status `401` - added the new `10027` enum value to the `errors/items/code` response property for the response status `403` - added the new `10027` enum value to the `errors/items/code` response property for the response status `404` - added the new `10027` enum value to the `errors/items/code` response property for the response status `503` - added the new `10027` enum value to the `oneOf[#/components/schemas/email_ErrorResponse]/errors/items/code` response property for the response status `422` - added the new `10036` enum value to the `errors/items/code` response property for the response status `400` - added the new `10036` enum value to the `errors/items/code` response property for the response status `401` - added the new `10036` enum value to the `errors/items/code` response property for the response status `403` - added the new `10036` enum value to the `errors/items/code` response property for the response status `404` - added the new `10036` enum value to the `errors/items/code` response property for the response status `503` - added the new `10036` enum value to the `oneOf[#/components/schemas/email_ErrorResponse]/errors/items/code` response property for the response status `422` - added the new optional `header` request parameter `Idempotency-Key` - added the non-success response with the status `409` - added the non-success response with the status `413` - **2026-07-07** `6ef0ae248bf7` — 1 info - endpoint added - **2026-07-02** `224ed0d8a5c3` — 1 breaking - api path removed without deprecation --- [Operation](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/docs/email_messages/post.md) · [API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [Page](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/email_messages/post)