Skip to main content

Consent notificaions

This section describes notification which sends in case when endUser opt in or opt out his marketing consent during new purchase or via End User Portal.

History of changes

Change tagChange descriptionChange date
IAP-25364Initial version of create & update notifications is created20.03.2026

Event list

  • Consent is created type=created
  • Consent is updated type=updated
NameDescriptionR/O
subjectconsentR
typeDepends on the type of the notification: created, updatedR
objectIdConsent IdR
eventDateDate in ISO 8601 formatR
consent {object}Consent details objectR
consent.sourceThe origin of marketing consent creation, update. Values: purchase, enduserportalR
consent.userEmailEnd-User email addressR
consent.consents [{object}]Array of consent objects. For this type of notification there are always twoR
consent.consents.[].typeThe fixed list of values: newsletterOptin or abandonedCartOptOutR
consent.consents.[].statusBoolean indicates the value of consentR
consent.consents.[].lastUpdateReasonTextual comment of the action, f.e. "declare consent"R
consent.consents.[].lastLegalActionTimestampIt's provided only in case of direct endUser action, otherwise it's not sentO

Example

The normal pass of the flow assumes that for creation consnent the system will send two objects: newsletterOptin (depending on what was chosen on shopping-cart) & abandonedCartOptOut=false (always false meaning that endUser did not opt consent out for emails connected to abandoned cart campaigns)

{
"subject" : "consent",
"type" : "created",
"objectId" : "4ecaf60b-ed62-4b95-b986-156648044551",
"eventDate" : "2026-03-17T09:51:36Z",
"consent" : {
"source" : "purchase",
"userEmail" : "[email protected]",
"consents" : [
{
"type" : "newsletterOptin",
"status" : true,
"lastUpdateReason" : "declare consent"
},
{
"type" : "abandonedCartOptOut",
"status" : false,
"lastUpdateReason" : "declare consent"
} ]
}
}

Then there are following use cases exist:

  1. Revoke abandonedCartOptOut cart consent via a special link provided in abandoned cart email, the payload will look following:
{
"subject" : "consent",
"type" : "updated",
"objectId" : "4ecaf60b-ed62-4b95-b986-156648044551",
"eventDate" : "2026-03-17T09:51:36Z",
"consent" : {
"source" : "purchase",
"userEmail" : "[email protected]",
"consents" : [
{
"type" : "abandonedCartOptOut",
"status" : true,
"lastUpdateReason" : "revoke consent",
"lastLegalActionTimestamp": 1773761609454
}
]
}
}
  1. Change newsletterOptin via end user portal
{
"subject" : "consent",
"type" : "updated",
"objectId" : "4ecaf60b-ed62-4b95-b986-156648044551",
"eventDate" : "2026-03-17T09:51:36Z",
"consent" : {
"source" : "enduserportal",
"userEmail" : "[email protected]",
"consents" : [
{
"type" : "newsletterOptin",
"status" : true,
"lastUpdateReason" : "force consent",
"lastLegalActionTimestamp": 1773761609454
}
]
}
}