Webhooks - Offer Topics

Cleeng Webhooks

Webhooks are notifications that Cleeng sends out to subscribed publishers about certain events occurring in the platform. The events are sent in the form of a POST request made to specified endpoints with a JSON payload as its body.

The body of the request consists of three constant fields:

broadcasterId – the ID of the publisher that the webhook is sent for,
topic – the name of the topic that the webhook is sent about,
data – topic-specific payload about the event.

Available Offer Topics

offerCreated

Trigger:
The event is triggered whenever an offer is created. Supported offer types include subscription, pass, live pay-per-view, and TVOD.

For more information on offers, see What is a Cleeng offer?.

{
    "broadcasterId": 123123123, // same as  publisherId
    "topic": "offerCreated",
    "data": {
        "offerId": "S123123123",
        "createdAt": "2025-05-05T10:48:09+02:00"
    }
}

offerUpdated

Trigger:
The event is triggered whenever an offer is updated (for example: title, description or trial period is updated, or event start or end date is updated for a live pay-per-view offer, etc.).

{
    "broadcasterId": 123123123, // same as  publisherId
    "topic": "offerUpdated",
    "data": {
        "offerId": "S123123123",
        "updatedAt": "2025-05-05T10:51:45+02:00"
    }
}

offerDeactivated

Trigger:
The event is triggered whenever an offer is deactivated.

{
    "broadcasterId": 123123123, // same as  publisherId
    "topic": "offerDeactivated",
    "data": {
        "offerId": "S123123123",
        "deactivatedAt": "2025-05-05T10:53:15+02:00"
    }
}

offerPriceChanged

Trigger:
The event is triggered whenever the offer price is changed.

{
    "broadcasterId": 123123123, // same as  publisherId
    "topic": "offerPriceChanged",
    "data": {
        "offerId": "S123123123",
        "updatedAt": "2025-05-05T10:51:45+02:00"
    }
}