---
title: "Changes to Create or update subscriber"
method: POST
path: "/subscribers"
---

# Changes to Create or update subscriber

`POST /subscribers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 15 of 150 revisions.

- **2026-10-16** `db3873ca3d4d`: 4 info
- **2026-09-08** `f1d8cfd9faaf`: 3 breaking, 1 info
- **2026-08-31** `e1667306c303`: 2 info
- **2026-08-19** `ba3a29c6eb33`: 3 info
- **2026-08-18** `8fbabe82a04d`: 2 info
- **2026-08-16** `6fd2903b91ce`: 3 info
- **2026-08-10** `16ad4f8e3d97`: 1 info
- **2026-08-04** `aa6181241c7f`: 1 info
- **2026-08-02** `36f92fc0caa2`: 3 breaking
- **2026-07-31** `6a6a58564a5e`: 1 breaking
- **2026-07-31** `81af3c514e06`: 1 info
- **2026-07-10** `1b0d5fa83cd8`: 5 info
- **2026-05-19** `1a51a400be50`: 3 info
- **2026-05-05** `5449b620579f`: 3 info
- **2026-04-11** `b6d39ca47951`: 1 warning, 1 info

## Changes

- **2026-10-16** `db3873ca3d4d`: 4 info
  - added the optional property `issues` to the response with the `400` status
  - added the optional property `issues` to the response with the `401` status
  - added the optional property `issues` to the response with the `403` status
  - added the optional property `issues` to the response with the `500` status
- **2026-09-08** `f1d8cfd9faaf`: 3 breaking, 1 info
  - the request property `phone` became not nullable
  - the request property `phoneCountry` became not nullable
  - the request property `timezone` became not nullable
  - added the optional property `subscriber/allOf[#/components/schemas/Subscriber]/phoneCountry` to the response with the `200` status
- **2026-08-31** `e1667306c303`: 2 info
  - the `enrollInSequences` request property default value `true` was removed
  - added the non-success response with the status `403`
- **2026-08-19** `ba3a29c6eb33`: 3 info
  - added the optional property `retryable` to the response with the `400` status
  - added the optional property `retryable` to the response with the `401` status
  - added the optional property `retryable` to the response with the `500` status
- **2026-08-18** `8fbabe82a04d`: 2 info
  - added the new optional request property `timezone`
  - added the optional property `subscriber/allOf[#/components/schemas/Subscriber]/timezone` to the response with the `200` status
- **2026-08-16** `6fd2903b91ce`: 3 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `500` status
- **2026-08-10** `16ad4f8e3d97`: 1 info
  - added the optional property `subscriber/allOf[#/components/schemas/Subscriber]/unsubscribedAt` to the response with the `200` status
- **2026-08-04** `aa6181241c7f`: 1 info
  - added the new optional request property `phoneCountry`
- **2026-08-02** `36f92fc0caa2`: 3 breaking
  - the response property `success` became optional for the status `400`
  - the response property `success` became optional for the status `401`
  - the response property `success` became optional for the status `500`
- **2026-07-31** `6a6a58564a5e`: 1 breaking
  - the response property `subscriber/allOf[#/components/schemas/Subscriber]/email` became nullable for the status `200`
- **2026-07-31** `81af3c514e06`: 1 info
  - added the new optional request property `createdAt`
- **2026-07-10** `1b0d5fa83cd8`: 5 info
  - added the new optional request property `phone`
  - added the new optional request property `smsConsent`
  - added the non-success response with the status `400`
  - added the optional property `subscriber/allOf[#/components/schemas/Subscriber]/phone` to the response with the `200` status
  - added the optional property `subscriber/allOf[#/components/schemas/Subscriber]/smsStatus` to the response with the `200` status
- **2026-05-19** `1a51a400be50`: 3 info
  - added the new optional request property `optInMode`
  - added the new `bounced` enum value to the request property `status`
  - added the optional property `optIn` to the response with the `200` status
- **2026-05-05** `5449b620579f`: 3 info
  - added the new optional request property `externalId`
  - the request property `email` became optional
  - added the optional property `subscriber/allOf[#/components/schemas/Subscriber]/externalId` to the response with the `200` status
- **2026-04-11** `b6d39ca47951`: 1 warning, 1 info
  - added the new `bounced` enum value to the `subscriber/allOf[#/components/schemas/Subscriber]/status` response property for the response status `200`
  - added the optional property `subscriber/allOf[#/components/schemas/Subscriber]/emailProvider` to the response with the `200` status

---

[Operation](https://skmtc.dev/sequenzy/apis/sequenzy-api/docs/subscribers/post.md) - [API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) - [Page](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/subscribers/post)