WebhooksEvent catalogGamification
gamification.progress.updated
Version 1 of the gamification.progress.updated webhook event.
The gamification.progress.updated event.
| Event type | gamification.progress.updated |
| Schema version | 1 |
| Routing key | event.gamification.progress.updated.v1 |
| Produced by | Gamification |
| Schema | urn:defendr:contract:gamification:progress-updated:1 |
data fields
| Field | Type | Required | Description |
|---|---|---|---|
accountId | string | yes | |
playerId | string | yes | |
missionKey | string | yes | |
missionRevision | integer | yes | |
currentCount | integer | yes | |
requiredCount | integer | yes | |
status | "active", "completed", "expired" | yes | |
periodStart | string or null (date-time) | yes | |
updatedAt | string (date-time) | yes |
Some fields are required only in particular states. The JSON Schema below is authoritative.
Example delivery
Signed with the example secret whsec_placeholder_example_webhooks_signing_secret, so you can check your verifier against it. See Verifying signatures.
POST /your/webhook/endpoint HTTP/1.1
content-type: application/json
webhook-id: whd_00000000-0000-4000-8000-000000000018
webhook-timestamp: 1800000000
webhook-signature: v1,Jus3xIq43FFOLqH17KoeagS0nIUf6dK6EaeNgjf5qEw=
tanitar-event-type: gamification.progress.updated
tanitar-schema-version: 1
tanitar-delivery-attempt: 1
{"messageId":"evt_00000000-0000-4000-8000-000000000018","kind":"event","type":"gamification.progress.updated","schemaVersion":1,"occurredAt":"2027-01-15T10:00:00.000Z","producer":"gamification-service","accountId":"acc_11111111-1111-4111-8111-111111111111","correlationId":"corr_00000000-0000-4000-8000-000000000018","data":{"accountId":"acct_demo","playerId":"player_demo","missionKey":"core-win-valorant","missionRevision":1,"currentCount":1,"requiredCount":1,"status":"completed","periodStart":null,"updatedAt":"2026-09-08T00:00:00.000Z"}}The same body, formatted:
{
"messageId": "evt_00000000-0000-4000-8000-000000000018",
"kind": "event",
"type": "gamification.progress.updated",
"schemaVersion": 1,
"occurredAt": "2027-01-15T10:00:00.000Z",
"producer": "gamification-service",
"accountId": "acc_11111111-1111-4111-8111-111111111111",
"correlationId": "corr_00000000-0000-4000-8000-000000000018",
"data": {
"accountId": "acct_demo",
"playerId": "player_demo",
"missionKey": "core-win-valorant",
"missionRevision": 1,
"currentCount": 1,
"requiredCount": 1,
"status": "completed",
"periodStart": null,
"updatedAt": "2026-09-08T00:00:00.000Z"
}
}JSON Schema
urn:defendr:contract:gamification:progress-updated:1
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "urn:defendr:contract:gamification:progress-updated:1",
"title": "Gamification mission progress updated event payload",
"type": "object",
"additionalProperties": false,
"required": [
"accountId",
"playerId",
"missionKey",
"missionRevision",
"currentCount",
"requiredCount",
"status",
"periodStart",
"updatedAt"
],
"properties": {
"accountId": {
"type": "string",
"minLength": 1
},
"playerId": {
"type": "string",
"minLength": 1
},
"missionKey": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
},
"missionRevision": {
"type": "integer",
"minimum": 1
},
"currentCount": {
"type": "integer",
"minimum": 0
},
"requiredCount": {
"type": "integer",
"minimum": 1
},
"status": {
"enum": [
"active",
"completed",
"expired"
]
},
"periodStart": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"updatedAt": {
"type": "string",
"format": "date-time"
}
}
}