---
title: "Changes to Create and send a one-time send"
method: POST
path: "/v1/newsletters"
---

# Changes to Create and send a one-time send

`POST /v1/newsletters`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 30 revisions.

- **2026-10-03** `f3a28f896929`: 1 breaking, 4 info
- **2026-09-21** `7aca33a41082`: 33 info
- **2026-09-02** `5da2740beeb5`: 1 info

## Changes

- **2026-10-03** `f3a28f896929`: 1 breaking, 4 info
  - the response property `newsletter/sent_at` became nullable for the status `200`
  - added the optional property `newsletter/scheduled_at` to the response with the `200` status
  - added the optional property `newsletter/send_state` to the response with the `200` status
  - added the optional property `newsletter/timezone` to the response with the `200` status
  - added the optional property `newsletter/tz_match_enabled` to the response with the `200` status
- **2026-09-21** `7aca33a41082`: 33 info
  - added the new optional request property `oneOf[subschema #1: Email]/allOf[#/components/schemas/createNewsletterCommon]/deduped`
  - added the new optional request property `oneOf[subschema #1: Email]/allOf[#/components/schemas/createNewsletterCommon]/expires_after`
  - added the new optional request property `oneOf[subschema #1: Email]/allOf[#/components/schemas/createNewsletterCommon]/recipient_file_url`
  - added the new optional request property `oneOf[subschema #1: Email]/allOf[#/components/schemas/createNewsletterCommon]/tag_ids`
  - added the new optional request property `oneOf[subschema #2: SMS]/allOf[#/components/schemas/createNewsletterCommon]/deduped`
  - added the new optional request property `oneOf[subschema #2: SMS]/allOf[#/components/schemas/createNewsletterCommon]/expires_after`
  - added the new optional request property `oneOf[subschema #2: SMS]/allOf[#/components/schemas/createNewsletterCommon]/recipient_file_url`
  - added the new optional request property `oneOf[subschema #2: SMS]/allOf[#/components/schemas/createNewsletterCommon]/tag_ids`
  - added the new optional request property `oneOf[subschema #3: Push]/allOf[#/components/schemas/createNewsletterCommon]/deduped`
  - added the new optional request property `oneOf[subschema #3: Push]/allOf[#/components/schemas/createNewsletterCommon]/expires_after`
  - added the new optional request property `oneOf[subschema #3: Push]/allOf[#/components/schemas/createNewsletterCommon]/recipient_file_url`
  - added the new optional request property `oneOf[subschema #3: Push]/allOf[#/components/schemas/createNewsletterCommon]/tag_ids`
  - added the new optional request property `oneOf[subschema #4: In-App]/allOf[#/components/schemas/createNewsletterCommon]/deduped`
  - added the new optional request property `oneOf[subschema #4: In-App]/allOf[#/components/schemas/createNewsletterCommon]/expires_after`
  - added the new optional request property `oneOf[subschema #4: In-App]/allOf[#/components/schemas/createNewsletterCommon]/recipient_file_url`
  - added the new optional request property `oneOf[subschema #4: In-App]/allOf[#/components/schemas/createNewsletterCommon]/tag_ids`
  - added the new optional request property `oneOf[subschema #5: Webhook]/allOf[#/components/schemas/createNewsletterCommon]/deduped`
  - added the new optional request property `oneOf[subschema #5: Webhook]/allOf[#/components/schemas/createNewsletterCommon]/expires_after`
  - added the new optional request property `oneOf[subschema #5: Webhook]/allOf[#/components/schemas/createNewsletterCommon]/recipient_file_url`
  - added the new optional request property `oneOf[subschema #5: Webhook]/allOf[#/components/schemas/createNewsletterCommon]/tag_ids`
  - added the new optional request property `oneOf[subschema #6: Inbox message]/allOf[#/components/schemas/createNewsletterCommon]/deduped`
  - added the new optional request property `oneOf[subschema #6: Inbox message]/allOf[#/components/schemas/createNewsletterCommon]/expires_after`
  - added the new optional request property `oneOf[subschema #6: Inbox message]/allOf[#/components/schemas/createNewsletterCommon]/recipient_file_url`
  - added the new optional request property `oneOf[subschema #6: Inbox message]/allOf[#/components/schemas/createNewsletterCommon]/tag_ids`
  - the request property `oneOf[subschema #1: Email]/allOf[#/components/schemas/createNewsletterCommon]/recipients` became optional
  - the request property `oneOf[subschema #2: SMS]/allOf[#/components/schemas/createNewsletterCommon]/recipients` became optional
  - the request property `oneOf[subschema #3: Push]/allOf[#/components/schemas/createNewsletterCommon]/recipients` became optional
  - the request property `oneOf[subschema #4: In-App]/allOf[#/components/schemas/createNewsletterCommon]/recipients` became optional
  - the request property `oneOf[subschema #5: Webhook]/allOf[#/components/schemas/createNewsletterCommon]/recipients` became optional
  - the request property `oneOf[subschema #6: Inbox message]/allOf[#/components/schemas/createNewsletterCommon]/recipients` became optional
  - added the optional property `newsletter/expires_after` to the response with the `200` status
  - added the optional property `newsletter/recipient_file_error` to the response with the `200` status
  - added the optional property `newsletter/recipient_file_status` to the response with the `200` status
- **2026-09-02** `5da2740beeb5`: 1 info
  - added the media type `application/json` for the response with the status `429`

---

[Operation](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/docs/v1/newsletters/post.md) - [API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) - [Page](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/changes/v1/newsletters/post)