Skip to main content
WEBHOOK
GiftLeaderboardUpdated
{
  "event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "event_timestamp": "<string>",
  "payload": {
    "network_id": 123,
    "recalculated_at": "2026-03-04T22:37:55+00:00",
    "type": "received",
    "entries": {
      "all_time": [
        {
          "rank": 123,
          "member": {
            "id": "1234",
            "created_at": "2026-03-04T22:37:54+00:00",
            "updated_at": "2026-03-04T22:37:54+00:00",
            "email": "ada.lovelace@example.com",
            "permalink": "<string>",
            "first_name": "<string>",
            "last_name": "<string>",
            "time_zone": "<string>",
            "location": "<string>",
            "bio": "<string>",
            "referral_count": 123,
            "avatar": "<string>",
            "categories": "<string>",
            "ambassador_level": "<string>"
          },
          "count": 123
        }
      ]
    },
    "gift_definition": {
      "id": 123,
      "name": "<string>"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Webhook payload

​
event_id
string<uuid>
required
​
event_timestamp
string<datetime>
required
​
payload
object
required

Payload sent when a gift leaderboard is updated for a network

Response

200

Return any 2xx status to indicate that the payload has been successfully received.

Any other response will cause the webhook to retry up to 5 times, over a period of several hours.