Webhooks & Events

The V1 API utilizes webhooks for publishing events. You can provide a webhook URL in your API dashboard.

Listening to events

First, you need a publicly accessible server with an endpoint listening to POST requests. Enter this URL in your dashboard. Additionally you may enter a "Webhook Secret" along the way. This can be any text of 64 characters or less and will be sent with every webhook call in order for you to authorize that the webhook call came from us.

Every webhook event payload looks like this:

Description

{
    "event": <event_name>,
    "secret?": <webhook_secret>,
    "data": <object | array>
}

Example

{
    "event": "free_games",
    "secret": "wdaji29dJadj91jAjd9a92eDak2",
    "data": [ 142312, 499128 ]
}

? fields are optional

Available Events

Free Games

{
    "event": "free_games",
    "data": [
        <game_ids>
    ]
}