Skip to main content
WEBHOOK
MemberBadgeAdded
{
  "event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "event_timestamp": "<string>",
  "payload": {
    "member": {
      "id": "1234",
      "created_at": "2025-11-07T23:17:21+00:00",
      "updated_at": "2025-11-07T23:17:21+00:00",
      "email": "ada.lovelace@example.com",
      "first_name": "<string>",
      "last_name": "<string>",
      "time_zone": "<string>",
      "location": "<string>",
      "referral_count": 123,
      "avatar": "<string>",
      "categories": "<string>",
      "permalink": "<string>",
      "ambassador_level": "<string>"
    },
    "badge": {
      "id": "1234",
      "created_at": "2025-11-07T23:17:23+00:00",
      "updated_at": "2025-11-07T23:17:23+00:00",
      "title": "Top Contributor",
      "description": "Awarded for exceptional contributions",
      "color": "#FFD700",
      "custom_field_id": 123,
      "avatar_url": "<string>"
    },
    "network_id": 123
  }
}

Body

application/json

Webhook payload

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

Payload sent when a badge is added to a member

Response

200

Return a 200 OK to indiate 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 (TODO)