Skip to content

Notifications

AD80 can tell you when it has classified a creative, when a creative breaks your rules, and when a key is about to expire. You choose the channel, the events, the filters, the language and how often.

ChannelWhat you get
E-mailA message in English or Arabic (HTML and plain text) with the app, the rules and scores, the network, the placement and a link to the creative image. Every message has an unsubscribe link, and mail programs can unsubscribe in one click.
WebhookAn HTTPS POST with a JSON body, signed with your secret. See Webhook events.

Notification channels are included in the Starter and Enterprise plans. You set them up on the Notifications page or with the Notifications API.

EventWhen
creative.violationA creative’s new verdict breaks at least one rule.
creative.classifiedA creative was classified (whether or not it breaks a rule).
key.expiringAn upload key or API key with an expiry date is about to expire.

Each subscription chooses its events and can be narrowed by filters: apps, rules and a minimum score.

A new subscription receives nothing until you prove the destination is yours:

  • E-mail: AD80 sends a confirmation e-mail. Open the link and press Confirm. The link is valid for 48 hours.
  • Webhook: AD80 posts a notify.verify event to your URL. Its data.code (starting with vc_) is a one-time code; send it back to POST /v1/notifications/subscriptions/{id}/confirm. See Verify a destination.

Changing the destination requires a new verification.

ModeBehaviour
immediateOne message per event.
digest_hourlyOne message per hour with the events of that hour.
digest_dailyOne message per day.

Classification and violation alerts sent to an immediate subscription are expedited notifications; your plan includes a monthly number of them, and under normal operation they arrive within minutes. When the monthly allowance is used up, later alerts are not lost: they arrive in the subscription’s hourly digest, and the message says the allowance was reached (webhooks carry "expedited": false). The allowance renews at the start of the next calendar month (UTC).

  • A delivery is tried until your endpoint accepts it or for 24 hours, with growing waits. See Delivery, retries and idempotency.
  • Delivery is at least once: a message can occasionally arrive twice. Webhook receivers de-duplicate with the delivery id; e-mail has no such guarantee.
  • The delivery log (dashboard or API) shows every delivery and attempt, and lets you redeliver.

If your plan loses a channel, your subscriptions stay but nothing is sent on that channel, and they cannot be turned on again until the plan includes the channel.