--- title: "Changes to Create a notification setting" method: POST path: "/notification-settings" --- # Changes to Create a notification setting `POST /notification-settings` > Every recorded change to this operation, newest first. ## Timeline Changed in 8 of 19 revisions. - **2026-10-26** (v1) `bbc0c72039c8`: 1 breaking - **2026-02-02** (v1) `9ba8be0f2006`: 20 breaking, 1 warning, 84 info - **2025-05-27** (v1) `e57c515077cc`: 5 warning, 5 info - **2025-05-07** (v1) `aeb882657253`: 3 warning, 3 info - **2025-04-25** (v1) `c4b1322e66ca`: 2 breaking, 1 warning, 1 info - **2024-12-06** (v1) `274e5b2be190`: 2 info - **2024-08-06** (v1) `968e505782d4`: 1 breaking, 42 warning, 42 info - **2024-02-19** (v1) `a4a4068ff792`: 5 info ## Changes - **2026-10-26** (v1) `bbc0c72039c8`: 1 breaking - the `description` request property's maxLength was decreased to `256` - **2026-02-02** (v1) `9ba8be0f2006`: 20 breaking, 1 warning, 84 info - request body became required - added `#/components/schemas/NotificationSettingId` to the `id` request property `allOf` list - added `#/components/schemas/NotificationSettingTrafficSource` to the `traffic_source` request property `allOf` list - added `#/components/schemas/NotificationSettingType` to the `type` request property `allOf` list - removed the enum value `all` of the request property `traffic_source` - removed the enum value `email` of the request property `type` - removed the enum value `platform` of the request property `traffic_source` - removed the enum value `simulation` of the request property `traffic_source` - removed the enum value `url` of the request property `type` - the `traffic_source` request property type changed from `string` to no type - the `type` request property type changed from `string` to no type - the `data/id` response's property type changed from `string` to no type for status `201` - the `data/subscribed_events/items/name` response's property type changed from `string` to no type for status `201` - the `data/traffic_source` response's property type changed from `string` to no type for status `201` - the `data/type` response's property type changed from `string` to no type for status `201` - the `error` response's property type changed from `object` to no type for status `default` - removed the required property `error/code` from the response with the `default` status - removed the required property `error/detail` from the response with the `default` status - removed the required property `error/documentation_url` from the response with the `default` status - removed the required property `error/type` from the response with the `default` status - removed the optional property `error/errors` from the response with the `default` status - added the new `api_key_exposure.created` enum value to the request property `subscribed_events/items/` - added the new `client_token.created` enum value to the request property `subscribed_events/items/` - added the new `client_token.revoked` enum value to the request property `subscribed_events/items/` - added the new `client_token.updated` enum value to the request property `subscribed_events/items/` - added the new `discount_group.created` enum value to the request property `subscribed_events/items/` - added the new `discount_group.updated` enum value to the request property `subscribed_events/items/` - removed the pattern `^ntfset_[a-z\d]{26}$` from the request property `id` - added `#/components/schemas/ApiError` to the `error` response property `allOf` list for the response status `default` - added `#/components/schemas/EventTypeName` to the `data/subscribed_events/items/name` response property `allOf` list for the response status `201` - added `#/components/schemas/NotificationSettingId` to the `data/id` response property `allOf` list for the response status `201` - added `#/components/schemas/NotificationSettingTrafficSource` to the `data/traffic_source` response property `allOf` list for the response status `201` - added `#/components/schemas/NotificationSettingType` to the `data/type` response property `allOf` list for the response status `201` - the response property `data/active` became required for the status `201` - the response property `data/api_version` became required for the status `201` - the response property `data/description` became required for the status `201` - the response property `data/destination` became required for the status `201` - the response property `data/endpoint_secret_key` became required for the status `201` - the response property `data/id` became required for the status `201` - the response property `data/include_sensitive_fields` became required for the status `201` - …65 more - **2025-05-27** (v1) `e57c515077cc`: 5 warning, 5 info - added the new `api_key.created` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `api_key.expired` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `api_key.expiring` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `api_key.revoked` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `api_key.updated` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `api_key.created` enum value to the request property `subscribed_events/items/` - added the new `api_key.expired` enum value to the request property `subscribed_events/items/` - added the new `api_key.expiring` enum value to the request property `subscribed_events/items/` - added the new `api_key.revoked` enum value to the request property `subscribed_events/items/` - added the new `api_key.updated` enum value to the request property `subscribed_events/items/` - **2025-05-07** (v1) `aeb882657253`: 3 warning, 3 info - added the new `payment_method.deleted` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `payment_method.saved` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `transaction.revised` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `payment_method.deleted` enum value to the request property `subscribed_events/items/` - added the new `payment_method.saved` enum value to the request property `subscribed_events/items/` - added the new `transaction.revised` enum value to the request property `subscribed_events/items/` - **2025-04-25** (v1) `c4b1322e66ca`: 2 breaking, 1 warning, 1 info - the `destination` request property's minLength was increased from `0` to `1` - the `data/description` response property's maxLength was increased from `256` to `500` for the response status `201` - the `destination` request property's maxLength was set to `2048` - the `description` request property's maxLength was increased from `256` to `500` - **2024-12-06** (v1) `274e5b2be190`: 2 info - added the new optional request property `traffic_source` - added the optional property `data/traffic_source` to the response with the `201` status - **2024-08-06** (v1) `968e505782d4`: 1 breaking, 42 warning, 42 info - request property `subscribed_events/items/` was restricted to a list of enum values - added the new `address.created` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `address.imported` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `address.updated` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `adjustment.created` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `adjustment.updated` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `business.created` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `business.imported` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `business.updated` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `customer.created` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `customer.imported` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `customer.updated` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `discount.created` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `discount.imported` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `discount.updated` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `payout.created` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `payout.paid` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `price.created` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `price.imported` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `price.updated` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `product.created` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `product.imported` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `product.updated` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `report.created` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `report.updated` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `subscription.activated` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `subscription.canceled` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `subscription.created` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `subscription.imported` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `subscription.past_due` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `subscription.paused` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `subscription.resumed` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `subscription.trialing` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `subscription.updated` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `transaction.billed` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `transaction.canceled` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `transaction.completed` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `transaction.created` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `transaction.paid` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - added the new `transaction.past_due` enum value to the `data/subscribed_events/items/name` response property for the response status `201` - …45 more - **2024-02-19** (v1) `a4a4068ff792`: 5 info - api tag `Notification settings` added - api tag `Notifications` removed - removed the non-success response with the status `400` - removed the non-success response with the status `401` - removed the non-success response with the status `500` --- [Operation](https://skmtc.dev/paddlehq/apis/paddle-api/docs/notification-settings/post.md) - [API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [Page](https://skmtc.dev/paddlehq/apis/paddle-api/changes/notification-settings/post)