Basic

Upsert subscription

Create a new webhook journal subscription for the specified portal. This endpoint allows you to define the actions and object types that the subscription will monitor. It requires a request body with the subscription details.

post/webhooks-journal/subscriptions/2026-03

Request body

Response

successful operation

actionOverridesobject

An object containing overrides for actions, where each key is an action and the value is an ActionOverrideRequest object.

actionsstring[] required

An array of actions associated with the subscription. Valid actions include 'CREATE', 'UPDATE', 'DELETE', 'MERGE', 'RESTORE', 'ASSOCIATION_ADDED', 'ASSOCIATION_REMOVED', 'SNAPSHOT', 'APP_INSTALL', 'APP_UNINSTALL', 'ADDED_TO_LIST', 'REMOVED_FROM_LIST', and 'GDPR_DELETE'.

appIdinteger required

The unique identifier for the app associated with the subscription, represented as an integer.

associatedObjectTypeIdsstring[]

An array of strings representing the IDs of associated object types.

createdAtstring date-time required

The date and time when the subscription was created, in ISO 8601 format.

createdByinteger

The unique identifier of the user who created the subscription, represented as an integer.

deletedAtstring date-time

The date and time when the subscription was deleted, in ISO 8601 format, if applicable.

idinteger required

The unique identifier for the subscription, represented as an integer.

listIdsinteger[]

An array of integers representing the IDs of lists associated with the subscription.

objectIdsinteger[]

An array of integers representing the IDs of objects associated with the subscription.

objectTypeIdstring required

The identifier for the type of object associated with the subscription, represented as a string.

portalIdinteger

The unique identifier for the portal associated with the subscription, represented as an integer.

propertiesstring[]

An array of strings representing the properties associated with the subscription.

The type of subscription, indicating the nature of events it pertains to. Valid values include 'OBJECT', 'ASSOCIATION', 'EVENT', 'APP_LIFECYCLE_EVENT', 'LIST_MEMBERSHIP', and 'GDPR_PRIVACY_DELETION'.

updatedAtstring date-time required

The date and time when the subscription was last updated, in ISO 8601 format.

Changes

Changed in 5 of the 34 revisions of this API.457982

Jun 15, 20262026-0388217f2784d45502See the full diff
- ▲
  the request's body type changed from object to no type
  request-body-type-changed
- ▲
  the /// response's property type changed from object to string for status
  response-property-type-changed
- ▲
  the / response's property type changed from object to string for status
  response-property-type-changed
- ▲
  the / response's property type changed from object to string for status
  response-property-type-changed
- ▲
  the response's property type changed from object to string for status
  response-property-type-changed
- ●
  removed the request property
  request-property-removed
- ●
  removed the optional property //// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property //// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  added the new ADDED_TO_LIST enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new APP_INSTALL enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new APP_UNINSTALL enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ASSOCIATION_ADDED enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ASSOCIATION_REMOVED enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new CREATE enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new DELETE enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new GDPR_DELETE enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new MERGE enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new REMOVED_FROM_LIST enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new RESTORE enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new SNAPSHOT enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new UPDATE enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  removed request discriminator
  request-body-discriminator-removed
- ○
  added to the request body oneOf list
  request-body-one-of-added
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 15, 20262026-03e690d002596a651See the full diff
- ▲
  removed from the request body oneOf list
  request-body-one-of-removed
- ▲
  the request's body type changed from no type to object
  request-body-type-changed
- ▲
  the /// response's property type changed from string to object for status
  response-property-type-changed
- ▲
  the / response's property type changed from string to object for status
  response-property-type-changed
- ▲
  the / response's property type changed from string to object for status
  response-property-type-changed
- ▲
  the response's property type changed from string to object for status
  response-property-type-changed
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added request discriminator
  request-body-discriminator-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  removed the ADDED_TO_LIST enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the APP_INSTALL enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the APP_UNINSTALL enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the ASSOCIATION_ADDED enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the ASSOCIATION_REMOVED enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the CREATE enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the DELETE enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the GDPR_DELETE enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the MERGE enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the REMOVED_FROM_LIST enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the RESTORE enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the SNAPSHOT enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the UPDATE enum value from the / response property for the response status
  response-property-enum-value-removed
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 21, 20262026-0350947e7c98ef195See the full diff
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property //// became required
  request-property-became-required
- ○
  the request property //// with a default value became required
  request-property-became-required-with-default
- ○
  the request property //// with a default value became required
  request-property-became-required-with-default
- ○
  the request property //// with a default value became required
  request-property-became-required-with-default
- ○
  the request property //// with a default value became required
  request-property-became-required-with-default
- ○
  the request property //// with a default value became required
  request-property-became-required-with-default
May 20, 20262026-03be4b67e8608f5524See the full diff
- ▲
  the /// request property type changed from no type to object
  request-property-type-changed
- ▲
  the /// request property type changed from no type to object
  request-property-type-changed
- ▲
  the /// request property type changed from no type to object
  request-property-type-changed
- ▲
  the /// request property type changed from no type to object
  request-property-type-changed
- ▲
  the /// request property type changed from no type to object
  request-property-type-changed
- ●
  removed subschema #2 from the /// request property allOf list
  request-property-all-of-removed
- ●
  removed subschema #2 from the /// request property allOf list
  request-property-all-of-removed
- ●
  removed subschema #2 from the /// request property allOf list
  request-property-all-of-removed
- ●
  removed subschema #2 from the /// request property allOf list
  request-property-all-of-removed
- ●
  removed subschema #2 from the /// request property allOf list
  request-property-all-of-removed
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
May 5, 20262026-0341215ed942ec1024See the full diff
- ▲
  added subschema #2 to the /// request property allOf list
  request-property-all-of-added
- ▲
  added subschema #2 to the /// request property allOf list
  request-property-all-of-added
- ▲
  added subschema #2 to the /// request property allOf list
  request-property-all-of-added
- ▲
  added subschema #2 to the /// request property allOf list
  request-property-all-of-added
- ▲
  added subschema #2 to the /// request property allOf list
  request-property-all-of-added
- ▲
  the /// request property type changed from object to no type
  request-property-type-changed
- ▲
  the /// request property type changed from object to no type
  request-property-type-changed
- ▲
  the /// request property type changed from object to no type
  request-property-type-changed
- ▲
  the /// request property type changed from object to no type
  request-property-type-changed
- ▲
  the /// request property type changed from object to no type
  request-property-type-changed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
- ●
  removed the request property ////
  request-property-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history