Skip to main content

Sample webhook payloads

This page contains sample payloads for each of the webhook events currently supported by Dynamic Content. This information will be useful to you if you're developing a webhook integration, particularly when adding filters and creating custom payloads.

For information about customizing a webhook payload see custom payloads.

The payload in each webhook event will contain the ID of the item the event applies to. For example, the edition ID for a scheduled, unscheduled, or published edition and the content ID for the content created, updated or status updated events.

Also included in each payload is a set of HAL links, which you can follow for common actions related to the edition, content item or snapshot.

See the Dynamic Content Management API reference for more information about how you can make use of the information included in the payload.

Edition scheduled
Link copied!

This webhook event is triggered when an edition is scheduled in Dynamic Content. The payload will include:

  • the name of the edition and any comments added
  • the start and end date of the edition
  • the ID of the event that the edition is part of
  • activeEndDate: true if content is marked to expire at the edition's end date

The full example payload for the edition scheduled webhook event is shown below:

{
"sequenceId": 1,
"id": "704ffd56-cb61-43f0-8734-4bd4fbb1c772",
"name": "dynamic-content.edition.scheduled",
"requestId": "a7f9d7eb-a109-41a6-b79f-2618cd28ac3b",
"resource": "5cf679244cedfd000109d2ef",
"payload": {
"id": "5ddeb27d4cedfd0001c66dee",
"name": "November Launch edition",
"comment": "",
"start": "2019-11-28T00:00:00.000Z",
"end": "2019-11-30T23:59:59.999Z",
"eventId": "5ddeb273cff47e0001800275",
"publishingStatus": "SCHEDULED",
"slotsRemaining": 198,
"schedulingErrors": [],
"activeEndDate": false,
"publishingJobId": "5ddeb2d64cedfd0001c66e02",
"publishManifestId": "5ddeb2d54cedfd0001c66e01",
"statusUpdated": "2019-11-27T17:29:33.874Z",
"lastPublishingEventDate": "2019-11-27T17:31:09.076Z",
"schedulingUser": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"createdBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"createdDate": "2019-11-27T17:29:33.875Z",
"lastModifiedBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"lastModifiedDate": "2019-11-27T17:31:02.078Z",
"stagedDate": null,
"slotCollisions": false,
"_links": {
"self": {
"href": "https://api.amplience.net/v2/content/editions/5ddeb27d4cedfd0001c66dee"
},
"edition": {
"href": "https://api.amplience.net/v2/content/editions/5ddeb27d4cedfd0001c66dee"
}
}
}
}

Edition unscheduled
Link copied!

This web hook event is triggered when an edition is unscheduled. The payload will include:

  • the name of the edition and any comments
  • the publishing status: for an unscheduled edition this will be set back to Draft
  • the start and end date of the edition
  • the ID of the event that the edition is part of
  • activeEndDate: true if content is marked to expire at the edition's end date

The full example payload for the edition unscheduled webhook event is shown below:

{
"sequenceId": 1,
"id": "cd403c48-51d4-4183-8530-6967dd892104",
"name": "dynamic-content.edition.unscheduled",
"requestId": "0ec0d59b-bfa1-4e9e-add4-28739c825e53",
"resource": "5cf679244cedfd000109d2ef",
"payload": {
"id": "5ddeb27d4cedfd0001c66dee",
"name": "November Launch edition",
"comment": "",
"start": "2019-11-28T00:00:00.000Z",
"end": "2019-11-30T23:59:59.999Z",
"eventId": "5ddeb273cff47e0001800275",
"publishingStatus": "DRAFT",
"slotsRemaining": 198,
"schedulingErrors": [],
"activeEndDate": false,
"publishingJobId": null,
"statusUpdated": "2019-11-27T17:29:33.874Z",
"lastPublishingEventDate": "2019-11-27T17:33:27.591Z",
"schedulingUser": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"createdBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"createdDate": "2019-11-27T17:29:33.875Z",
"lastModifiedBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"lastModifiedDate": "2019-11-27T17:33:27.386Z",
"stagedDate": null,
"slotCollisions": false,
"_links": {
"self": {
"href": "https://api.amplience.net/v2/content/editions/5ddeb27d4cedfd0001c66dee"
},
"edition": {
"href": "https://api.amplience.net/v2/content/editions/5ddeb27d4cedfd0001c66dee"
}
}
}
}

Snapshot published
Link copied!

The Snapshot published webhook event is triggered in two ways: when a content item is published and when an edition is published on its start date. The information in the payload will vary according to how it was triggered.

The "createdFrom" field in the payload will indicate whether the webhook event was triggered when a content item was published or when an edition was published. For content items, "createdFrom" will be set to "content-item" and for editions it will be set to "edition".

Snapshot published when content item published
Link copied!

For the Snapshot published event triggered when a content item published, the payload will include:

  • the content item ID
  • the creation and modification date
  • the content type URI of the root content item
  • the content item label
  • the content item's locale (if one is set)
  • the content repository id
  • the content repository label
  • the createdFrom field will be set to "content-item"

Below is the full example payload for the snapshot published - content item published webhook event:

{
"sequenceId": 391,
"id": "9e47d094-10d1-4f52-a893-38fb8dc103bb",
"name": "dynamic-content.snapshot.published",
"requestId": "ac5a553a-e8a8-4bad-98e1-12958d3b05de",
"resource": "5cf679244cedfd000109d2ef",
"payload": {
"id": "60cc865a52faff0001987e70",
"comment": "Publish Manifest for content item products",
"createdDate": "2021-06-18T11:41:14.79Z",
"createdBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"createdFrom": "content-item",
"type": "SYSTEM",
"meta": [],
"taggedEditions": [],
"locale": null,
"rootContentItem": {
"label": "Products",
"contentTypeUri": "https://doc-example.com/root-node.json",
"contentRepositoryId": "5cf6792e4cedfd0001885b67",
"repositoryLabel": "Content",
"id": "573af254-e2a8-419b-b923-7718e8f7545c"
},
"rootContentItems": [
{
"label": "Products",
"contentTypeUri": "https://doc-example.com/root-node.json",
"contentRepositoryId": "5cf6792e4cedfd0001885b67",
"repositoryLabel": "Content",
"id": "573af254-e2a8-419b-b923-7718e8f7545c"
}
],
"_links": {
"self": {
"href": "https://api.amplience.net/v2/content/snapshots/60cc865a52faff0001987e70"
},
"snapshot": {
"href": "https://api.amplience.net/v2/content/snapshots/60cc865a52faff0001987e70"
}
}
}
}

Snapshot published when edition published
Link copied!

For the Snapshot published event triggered when an edition is published on its start date, the payload will include:

  • the ID of the published edition
  • the edition creation date
  • created from will be set to "edition"
  • rootContentItems contains an array of the top level slots contained in the edition that has been published
  • the id of each slot
  • the content repository id for each slot
  • the repository label for each slot
  • the content repository id for each content item
  • the repository label for each content item

The example below is created from an edition containing both slots and content added directly and not included in a slot.

Below is the full example payload for the snapshot published- edition published webhook event:

{
"sequenceId": 438,
"id": "d6f2a151-350f-433d-a76c-491580370b77",
"name": "dynamic-content.snapshot.published",
"requestId": "44ea6947-55f4-4477-87b6-8994ce965dca",
"resource": "5cf679244cedfd000109d2ef",
"payload": {
"id": "613f4780c9e77c00010fd68d",
"comment": "Publish Manifest for edition Autumn sale promo edition",
"createdDate": "2021-09-13T12:43:44.165Z",
"createdBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"createdFrom": "edition",
"type": "SYSTEM",
"meta": null,
"taggedEditions": null,
"locale": null,
"rootContentItem": null,
"rootContentItems": [
{
"label": "Winter collection slider",
"contentTypeUri": "https://unpkg.com/@amplience/dynamic-content-accelerators/dist/contentTypes/slider.json",
"contentRepositoryId": "5cf6792e4cedfd0001885b67",
"repositoryLabel": "Content",
"id": "a5d5e975-d7c8-45e5-a619-f319f9cf825e"
},
{
"label": "Summer collection sale- dresses",
"contentTypeUri": "https://unpkg.com/@amplience/dynamic-content-accelerators/dist/contentTypes/image.json",
"contentRepositoryId": "5cf6792e4cedfd0001885b67",
"repositoryLabel": "Content",
"id": "270427c3-b45e-4aab-ba13-699f82e2ac2f"
},
{
"label": "home-page-feature-slot",
"contentTypeUri": "http://docexample.com/tutorialbannerslot.json",
"contentRepositoryId": "5cf6793352faff0001c2bd7c",
"repositoryLabel": "Slots",
"id": "5d69bdef-df0b-4680-acfc-0bdaa2a82bed"
},
{
"label": "Summer collection- jeans",
"contentTypeUri": "https://unpkg.com/@amplience/dynamic-content-accelerators/dist/contentTypes/image.json",
"contentRepositoryId": "5cf6792e4cedfd0001885b67",
"repositoryLabel": "Content",
"id": "69bb7840-e808-46ad-a7f5-97b305867bc4"
}
],
"publishedEdition": {
"asOf": "2021-09-13T12:46:10Z"
},
"_links": {
"self": {
"href": "https://api.amplience.net/v2/content/snapshots/613f4780c9e77c00010fd68d"
},
"snapshot": {
"href": "https://api.amplience.net/v2/content/snapshots/613f4780c9e77c00010fd68d"
}
}
}
}

Edition published
Link copied!

The edition published webhook event is triggered when an edition is published on its start date. The payload will include:

  • The edition ID
  • The edition name, comment, start and end date
  • The edition last modified date and the user that modified it

The HAL links will include the API calls to get more information about the published edition.

Below is the full example payload for the edition published webhook event:

{
"sequenceId": 1,
"id": "8381a876-e781-495b-9fe9-f890b624010f",
"name": "dynamic-content.edition.published",
"requestId": "dea1c72c-dfe3-44e7-89b1-ac095f867e67",
"resource": "5cf679244cedfd000109d2ef",
"payload": {
"id": "5ddeb27d4cedfd0001c66dee",
"name": "November Launch edition",
"comment": "",
"start": "2019-11-27T17:53:00.000Z",
"end": "2019-11-30T23:59:59.999Z",
"eventId": "5ddeb273cff47e0001800275",
"publishingStatus": "PUBLISHED",
"slotsRemaining": 198,
"schedulingErrors": [],
"activeEndDate": false,
"publishingJobId": "5ddeb7834cedfd0001d70e05",
"publishManifestId": "5ddeb7834cedfd0001d70e04",
"statusUpdated": "2019-11-27T17:29:33.874Z",
"lastPublishingEventDate": "2019-11-27T17:53:07.477Z",
"schedulingUser": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"createdBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"createdDate": "2019-11-27T17:29:33.875Z",
"lastModifiedBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"lastModifiedDate": "2019-11-27T17:50:59.433Z",
"stagedDate": null,
"slotCollisions": false,
"_links": {
"self": {
"href": "https://api.amplience.net/v2/content/editions/5ddeb27d4cedfd0001c66dee"
},
"edition": {
"href": "https://api.amplience.net/v2/content/editions/5ddeb27d4cedfd0001c66dee"
}
}
}
}

Content item created
Link copied!

This webhook event is triggered when a content item is created in Dynamic Content. The payload includes the following:

  • the content ID
  • the content body for the created item. As shown in the example payload below, it will also include any linked items
  • the item version
  • the creation and modification dates and who created and modified the item
  • the folder id and label for the folder within which the item is stored
  • the repository id and label for the repository within which the item is stored
  • the workflow status and label if one is set
  • the item's locale if one is set
  • the ids of any assignees

Below is the full example payload for the content item created webhook event:

{
"sequenceId": 31,
"id": "9eda6be2-f4bd-4ab8-9bd3-fc01efb73e76",
"name": "dynamic-content.content-item.created",
"requestId": "bbff1ac7-7910-4cfa-8ec0-db7f8b9c975c",
"resource": "5cf679244cedfd000109d2ef",
"payload": {
"id": "2d9871c5-01bc-4a85-b6d9-1c0baa1607cc",
"contentRepositoryId": "5cf6792e4cedfd0001885b67",
"workflow": {
"state": "5ddea64ecff47e00017fffa0"
},
"folderId": "5ddeaf09c9e77c000137e2f1",
"body": {
"_meta": {
"name": "spring-carousel",
"schema": "http://example.com/carousel.json"
},
"slides": [
{
"_meta": {
"schema": "http://bigcontent.io/cms/schema/v1/core#/definitions/content-link"
},
"contentType": "http://example.com/carouselslide.json",
"id": "b848b43e-6e7f-482e-b652-cb076b6a9bb2"
},
{
"_meta": {
"schema": "http://bigcontent.io/cms/schema/v1/core#/definitions/content-link"
},
"contentType": "http://example.com/carouselslide.json",
"id": "da105865-fddc-4e3b-88eb-f7aaf11db860"
},
{
"_meta": {
"schema": "http://bigcontent.io/cms/schema/v1/core#/definitions/content-link"
},
"contentType": "http://example.com/carouselslide.json",
"id": "903f32d0-bc49-4398-948c-e53eac818909"
},
{
"_meta": {
"schema": "http://bigcontent.io/cms/schema/v1/core#/definitions/content-link"
},
"contentType": "http://example.com/carouselslide.json",
"id": "4acc9fac-d075-42a9-bf76-61055e0fdf59"
}
]
},
"version": 1,
"label": "Spring carousel",
"status": "ACTIVE",
"createdBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"locale": "fr-FR",
"createdDate": "2020-03-04T16:34:50.262Z",
"lastModifiedBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"lastModifiedDate": "2020-03-04T16:34:50.262Z",
"assignees": ["200827cd-f51c-4d3e-bb50-87623d1c5768"],
"assignedDate": "2020-03-04T16:34:50.187Z",
"repositoryLabel": "Content",
"workflowStatusLabel": "Draft",
"folderName": "My content folder",
"deliveryId": "2d9871c5-01bc-4a85-b6d9-1c0baa1607cc",
"_links": {
"self": {
"href": "https://api.amplience.net/v2/content/content-items/2d9871c5-01bc-4a85-b6d9-1c0baa1607cc"
},
"content-item": {
"href": "https://api.amplience.net/v2/content/content-items/2d9871c5-01bc-4a85-b6d9-1c0baa1607cc{?projection}",
"templated": true
}
}
}
}

Content item updated
Link copied!

This webhook event is triggered when a content item a change is made to a content item and the item is saved. The webhook will also be triggered when the item is published or unpublished.

The payload includes the following:

  • the content ID
  • the content body for the updated item. This will also include any linked items
  • the item version
  • the creation and modification dates and who created and modified the item
  • the folder id and label for the folder within which the item is stored
  • the repository id and label for the repository within which the item is stored
  • the workflow state and label if one is set
  • the item's locale if one is set
  • the ids of any assignees
  • the item's publishing status. This will be one of the following:
    • NONE. This item has never been published
    • EARLY. A previous version of this item has been published
    • LATEST. The latest version of the item is published
    • UNPUBLISHED. The item was previously been published but has been unpublished
  • if the item is unpublished, the date that the item was unpublished
  • if the item has been unpublished, the version that was last unpublished

Below is the full example payload for the content item updated webhook event:

{
"sequenceId": 1,
"id": "a03f2307-47f2-42b0-8542-1d10c9e55209",
"name": "dynamic-content.content-item.updated",
"requestId": "8e580779-fc9c-480b-8db2-ffabe192e5a1",
"resource": "5cf679244cedfd000109d2ef",
"payload": {
"id": "02a6c85b-a27f-491a-9983-41b4f4638782",
"contentRepositoryId": "5cf6792e4cedfd0001885b67",
"folderId": null,
"body": {
"_meta": {
"name": "Winter sale banner",
"schema": "http://docexample.com/tutorialbanner.json",
"deliveryKey": "test-delivery-key"
},
"background": {
"_meta": {
"schema": "http://bigcontent.io/cms/schema/v1/core#/definitions/image-link"
},
"id": "b54fff18-685d-4843-b765-c025dca05524",
"name": "woman-hat-snow",
"endpoint": "ampproduct",
"defaultHost": "cdn.media.amplience.net"
},
"headline": "Winter sale now on!",
"strapline": "Stay warm, stay stylish",
"calltoactiontext": "Grab a bargain",
"calltoactionurl": "https://www.example.com"
},
"version": 4,
"label": "Winter sale banner",
"status": "ACTIVE",
"createdBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"createdDate": "2021-10-04T13:36:41.405Z",
"lastModifiedBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"lastModifiedDate": "2024-05-08T08:58:49.011Z",
"lastPublishedVersion": 4,
"lastPublishedDate": "2024-05-20T15:14:06.137Z",
"lastUnpublishedVersion": 4,
"lastUnpublishedDate": "2024-05-20T15:15:50.000Z",
"publishingStatus": "UNPUBLISHED",
"repositoryLabel": "Content",
"deliveryId": "02a6c85b-a27f-491a-9983-41b4f4638782",
"_links": {
"self": {
"href": "https://api.amplience.net/v2/content/content-items/02a6c85b-a27f-491a-9983-41b4f4638782"
},
"content-item": {
"href": "https://api.amplience.net/v2/content/content-items/02a6c85b-a27f-491a-9983-41b4f4638782{?projection}",
"templated": true
}
}
}
}

Content item workflow updated
Link copied!

This webhook event is triggered when a content item's status is added or updated. The payload will include:

  • the id of the content item for which the status has been updated
  • the new workflow state id and label
  • the content tree for the item updated
  • the content item version (changing the status does not create a new version)
  • the folder id and label for the folder within which the item is stored
  • the repository id and label for the repository within which the item is stored
  • the item's locale if one is set
  • the ids of any assignees

Below is the full example payload for the content item workflow updated webhook event:

{
"sequenceId": 3,
"id": "a7beabb3-528c-422a-948a-b356b24f2af4",
"name": "dynamic-content.content-item.workflow.updated",
"requestId": "af4b5ce4-a42c-4fa0-894b-c21212efc959",
"resource": "5cf679244cedfd000109d2ef",
"payload": {
"id": "eefaf401-9551-41dd-aa5e-a5362990b1b7",
"contentRepositoryId": "5cf6792e4cedfd0001885b67",
"workflow": {
"state": "5ddea6344cedfd0001d70a44"
},
"folderId": "5ddeaf09c9e77c000137e2f1",
"body": {
"_meta": {
"name": "spring-banner",
"schema": "http://docexample.com/tutorialbanner.json"
},
"background": {
"_meta": {
"schema": "http://bigcontent.io/cms/schema/v1/core#/definitions/image-link"
},
"id": "499ceb10-18dc-48be-baa7-306f938928cd",
"name": "womaninfield",
"endpoint": "ampproduct",
"defaultHost": "cdn.media.amplience.net"
},
"headline": "Get ready for Spring",
"strapline": "It will be here before you know it",
"calltoactiontext": "Visit our Spring Collection",
"calltoactionurl": "http://www.example.com/spring"
},
"version": 7,
"label": "Spring banner",
"status": "ACTIVE",
"createdBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"locale": "fr-FR",
"createdDate": "2019-11-27T17:16:18.948Z",
"lastModifiedBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"lastModifiedDate": "2020-03-04T16:13:20.272Z",
"lastPublishedVersion": 4,
"lastPublishedDate": "2020-03-04T13:19:22.595Z",
"assignees": [
"1c9409a4-2f19-4f3a-932a-01af19fa112b",
"04939ebd-2ca7-4287-8628-e018e3651d7b"
],
"assignedDate": "2020-03-04T16:06:03.415Z",
"repositoryLabel": "Content",
"workflowStatusLabel": "Approved",
"folderName": "My content folder",
"deliveryId": "eefaf401-9551-41dd-aa5e-a5362990b1b7",
"_links": {
"self": {
"href": "https://api.amplience.net/v2/content/content-items/eefaf401-9551-41dd-aa5e-a5362990b1b7"
},
"content-item": {
"href": "https://api.amplience.net/v2/content/content-items/eefaf401-9551-41dd-aa5e-a5362990b1b7{?projection}",
"templated": true
}
}
}

Content item assignee updated
Link copied!

This webhook event is triggered when the assignees of a content item are added or updated.

The payload will include:

  • the ID of the content item for which the assignees have been updated
  • the current assignees (these are the assignee IDs)
  • the previous assignees (these are the assignee IDs)
  • the content tree for the item updated
  • the content item version (changing the assignee does not create a new version)

Below is the full example payload for the content item assignee updated webhook event:

{
"sequenceId": 1,
"id": "fe746c02-f682-4792-87ed-1eafc229c194",
"name": "dynamic-content.content-item.assigned",
"requestId": "2f3ea8b0-dd94-4805-b020-e66cd7af238c",
"resource": "5cf679244cedfd000109d2ef",
"payload": {
"id": "eefaf401-9551-41dd-aa5e-a5362990b1b7",
"contentRepositoryId": "5cf6792e4cedfd0001885b67",
"folderId": "5ddeaf09c9e77c000137e2f1",
"body": {
"_meta": {
"name": "spring-banner",
"schema": "http://docexample.com/tutorialbanner.json"
},
"background": {
"_meta": {
"schema": "http://bigcontent.io/cms/schema/v1/core#/definitions/image-link"
},
"id": "499ceb10-18dc-48be-baa7-306f938928cd",
"name": "womaninfield",
"endpoint": "ampproduct",
"defaultHost": "cdn.media.amplience.net"
},
"headline": "Get ready for Spring",
"strapline": "It will be here before you know it!",
"calltoactiontext": "Visit our Spring Collection",
"calltoactionurl": "http://www.example.com/spring"
},
"version": 4,
"label": "Spring banner",
"status": "ACTIVE",
"createdBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"createdDate": "2019-11-27T17:16:18.948Z",
"lastModifiedBy": "200827cd-f51c-4d3e-bb50-87623d1c5768",
"lastModifiedDate": "2020-03-04T13:05:33.283Z",
"lastPublishedVersion": 3,
"lastPublishedDate": "2020-03-02T10:30:43.195Z",
"assignees": [
"1c9409a4-2f19-4f3a-932a-01af19fa112b",
"200827cd-f51c-4d3e-bb50-87623d1c5768"
],
"assignedDate": "2020-03-04T13:05:33.274Z",
"previousAssignees": ["1c9409a4-2f19-4f3a-932a-01af19fa112b"],
"deliveryId": "eefaf401-9551-41dd-aa5e-a5362990b1b7",
"_links": {
"self": {
"href": "https://api.amplience.net/v2/content/content-items/eefaf401-9551-41dd-aa5e-a5362990b1b7"
},
"content-item": {
"href": "https://api.amplience.net/v2/content/content-items/eefaf401-9551-41dd-aa5e-a5362990b1b7{?projection}",
"templated": true
}
}
}
}

Custom payloads