This webhook is sent once when an entire issuance job finishes processing.
It provides a summary of the batch including total counts and any failures.
This fires regardless of whether all rewards succeeded or some failed.
Event
reward_batch.completed
Payload Description
The event type: reward_batch.completed
The time the event occurred (ISO8601)
Event data The ID of the completed issuance job
Final job state: completed or failed
Total number of identifiers in the batch
Number of rewards successfully issued
Number of failed issuances
Details of any failed issuances The identifier value (email or phone) that failed
Error message describing the failure
{
"event" : "reward_batch.completed" ,
"timestamp" : "2025-06-15T10:30:15Z" ,
"data" : {
"issuance_job_id" : "job_xyz789" ,
"state" : "completed" ,
"total_count" : 2 ,
"issued_count" : 1 ,
"failed_count" : 1 ,
"failures" : [
{
"user_identifier" : "+14155551234" ,
"reason" : "User not found"
}
]
}
}