Assignment created
Headers
HMAC SHA256 signature of the request body. Generated using the webhook's signing key and the raw JSON payload.
Generate the same value in your endpoint and compare it with this header to validate the webhook payload.
"a1b2c3d4e5f67890abcdef1234567890abcdef1234567890abcdef1234567890"
Body
Payload delivered for assignment-related events. Combines the assignment resource with
the common webhook envelope fields (event, timestamp, trigger, source).
See the Webhooks guide for a full example payload.
Single judging task for an entry, addressed to either a judge or a role within a given round and score set.
Created automatically by panel allocation rules or manually by a panel manager. Lifecycle is tracked in status; the judging outcome lives in score.
Exactly one of judge and role is populated.
Entry the assignment refers to.
Category the entry belongs to.
Chapter the category belongs to.
Comments attached to the assignment.
null for role-based assignments (where role is populated and judge is absent), since role holders do not own per-assignment comment threads.
Time the assignment was created.
Slug of the form attached to the entry.
How the assignment was created.
Known values include Manual, Automatic (Panel), Recused, and Stray. Other values are possible depending on the score-set mode.
Panels the assignment is associated with.
Judge assigned to score the entry.
null for role-based assignments where role is populated instead.
Role assigned to score the entry, used when the assignment is shared across all holders of a role rather than addressed to one judge.
null for judge-specific assignments where judge is populated.
Rounds the assignment applies to.
Score for this assignment, formatted per the score-set mode. null when no score has been recorded.
Shape varies by score-set mode. Two confirmed shapes:
Regular numeric or qualifying mode:
Voting mode:
VIP and top-pick modes follow their own conventions.
Score set used to evaluate the entry.
Short URL-safe identifier for the assignment.
Current state of the assignment.
Known values include To be scored, In progress, and Complete.
Time the assignment was last updated.
Human-readable name of the event that triggered the webhook.
"Assignment completed"
ISO 8601 formatted datetime indicating when the event occurred.
"2020-01-01T00:00:00Z"
Origin of the change that triggered the event.
ui, api Response
Return any 2xx status code to acknowledge receipt of the event.