Skip to navigation
WebhooksStudy

Treatment assigned

Sent when a treatment is assigned to a study group. The payload carries both the treatment and the study group.

Headers

SignaturestringRequiredformat: "^[0-9a-f]{64}$"

Lowercase hex-encoded HMAC-SHA256 of the raw request body, keyed with your webhook’s signing secret. Compute it over the bytes exactly as received, before parsing, and compare in constant time.

Payload

The payload of this webhook request is an object.
idstringRequiredformat: "^whe_[a-zA-Z0-9]{10,22}$"
Unique identifier for a webhook event. A retried delivery carries the same identifier, so use it to discard duplicates.
event"study.treatment.assigned"Required
The event that occurred.
versionenumRequired
A released version of the public API. Each OAuth client is registered against one version, which determines the response shape it receives.
Allowed values:
created_atdatetimeRequired

UTC timestamp with microsecond precision, always suffixed with Z, in the form yyyy-MM-ddTHH:mm:ss.SSSSSSZ.

payloadobjectRequired
A treatment and the study group it was assigned to.
client_idstringOptionalformat: "uuid"
The OAuth client whose API request caused the event. Omitted when the event did not originate from an API request, and on events that never carry it.

Response

2XX
Any 2xx status acknowledges the delivery, which is then not retried. The response body is ignored.