---
title: "Changes to Create a batch of email messages"
method: POST
path: "/email_messages/batch"
---

# Changes to Create a batch of email messages

`POST /email_messages/batch`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 61 revisions.

- **2026-07-29** `14417f208717` — 1 breaking, 1 warning
- **2026-07-28** `b1bf96d8391e` — 2 breaking, 6 warning, 22 info
- **2026-07-16** `2fb3b617430a` — 12 warning, 6 info
- **2026-07-14** `021f0faf96df` — 1 breaking, 1 warning
- **2026-07-12** `b3c5aebde44c` — 2 breaking, 5 warning, 5 info
- **2026-07-07** `6ef0ae248bf7` — 1 info
- **2026-07-02** `224ed0d8a5c3` — 1 breaking

## Changes

- **2026-07-29** `14417f208717` — 1 breaking, 1 warning
  - removed the success response with the status `202`
  - the optional response header `Idempotent-Replayed` removed for the status `207`
- **2026-07-28** `b1bf96d8391e` — 2 breaking, 6 warning, 22 info
  - removed the required property `data/items/inserted_at` from the response with the `202` status
  - removed the required property `data/items/inserted_at` from the response with the `207` status
  - removed the optional property `data/items/send_at` from the response with the `202` status
  - removed the optional property `data/items/send_at` from the response with the `207` status
  - removed the optional property `data/items/suppressed` from the response with the `202` status
  - removed the optional property `data/items/suppressed` from the response with the `207` status
  - added the new `daily_limit_exceeded` enum value to the `data/items/events/items/type` response property for the response status `202`
  - added the new `daily_limit_exceeded` enum value to the `data/items/events/items/type` response property for the response status `207`
  - added the new optional request property `messages/items/attachments/items/content_id`
  - added the new optional request property `messages/items/attachments/items/disposition`
  - added the new optional request property `messages/items/scheduled_at`
  - added the new optional request property `messages/items/tracking_settings`
  - the request property `messages/items/group_id` became nullable
  - request property `messages/items/send_at` deprecated
  - added the optional property `data/items/recipient_statuses` to the response with the `202` status
  - added the optional property `data/items/recipient_statuses` to the response with the `207` status
  - added the optional property `data/items/scheduled_at` to the response with the `202` status
  - added the optional property `data/items/scheduled_at` to the response with the `207` status
  - added the required property `data/items/attachments/items/content_id` to the response with the `202` status
  - added the required property `data/items/attachments/items/content_id` to the response with the `207` status
  - added the required property `data/items/attachments/items/disposition` to the response with the `202` status
  - added the required property `data/items/attachments/items/disposition` to the response with the `207` status
  - added the required property `data/items/attachments/items/sha256` to the response with the `202` status
  - added the required property `data/items/attachments/items/sha256` to the response with the `207` status
  - added the required property `data/items/attachments/items/size_bytes` to the response with the `202` status
  - added the required property `data/items/attachments/items/size_bytes` to the response with the `207` status
  - added the required property `data/items/attachments/items/url` to the response with the `202` status
  - added the required property `data/items/attachments/items/url` to the response with the `207` status
  - added the required property `data/items/created_at` to the response with the `202` status
  - added the required property `data/items/created_at` to the response with the `207` status
- **2026-07-16** `2fb3b617430a` — 12 warning, 6 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 `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 `422`
  - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `503`
  - 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 `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 `422`
  - added the new `reputation_suspended` enum value to the `errors/items/code` response property for the response status `503`
  - 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 `409` status
  - added the optional property `suppressed` to the response with the `413` status
  - added the optional property `suppressed` to the response with the `422` 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, 5 warning, 5 info
  - removed the required property `data/items/idempotency_key` from the response with the `202` status
  - removed the required property `data/items/idempotency_key` from the response with the `207` status
  - removed the request property `messages/items/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 `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 optional `header` request parameter `Idempotency-Key`
  - added the non-success response with the status `409`
  - added the non-success response with the status `413`
  - added the non-success response with the status `422`
  - added the non-success response with the status `503`
- **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/batch/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/batch/post)
