data.
Most events include the same few things: the promotion, the version of it, and who did it. Those are explained once under Shared details. Each event below then lists only what’s different about it.
A full example
Here is everything Adclear sends when a reviewer rejects a promotion.https://app.adclear.ai/v2/promotion/{data.promotion.id}/version/{data.version.id}.
Shared details
promotion
promotion
The promotion the event is about. The promotion’s actual wording and images are not included.
version
version
One version of the promotion.
promotionId points back to the parent.Person (changedBy, submittedBy, decidedBy)
Person (changedBy, submittedBy, decidedBy)
The person who took the action.
comment
comment
Evaluation issue
Evaluation issue
One problem Adclear found when it checked a promotion.
Status values
status, previousStatus and newStatus use these values: saved, pending, expired, in_review, approved, rejected, changes_needed, conditionally_approved, escalated, reviewing_risk, risk_accepted. See Promotion statuses for what each one means.
Events
Every event includespromotion and version. The tables show what each one adds.
promotion.created
promotion.created
A promotion was created, along with its first version. Nothing extra is added. The test event you send from Settings is one of these, with IDs made of zeros.
promotion.status_changed
promotion.status_changed
A promotion version moved to a new status, for example from
in_review to approved.promotion.version_created
promotion.version_created
A new version was added to an existing promotion.
review.submitted
review.submitted
A version was submitted and is waiting on a reviewer.
review.approved
review.approved
A reviewer approved a version, either outright or with conditions.
review.changes_requested
review.changes_requested
A reviewer asked for changes before the version can be approved.
review.rejected
review.rejected
A reviewer rejected a version. Same fields as
review.changes_requested. See A full example.comment.created
comment.created
Someone added a comment to a version.
evaluation.completed
evaluation.completed
Adclear finished checking a promotion, whether the check worked or not.
Related pages
Webhooks
How webhooks are sent, checked and retried.
Webhook recipes
Examples in Zapier, Slack and Jira.
idthreadIdauthorUserIdcontentisComplianceCommentcreatedAt