Event Payload

Envelope

Every Medallion webhook is delivered with the following JSON body:

{
  "type": "payer_enrollment.request.in_progress.v1",
  "data": {
    ...event-specific fields...
  }
}
FieldTypeDescription
typestringThe event type name
dataobjectEvent-specific payload — see the event catalog for the event type

Headers

Delivery metadata is carried in HTTP headers, not in the JSON body:

HeaderDescription
webhook-idUnique event ID. Use as a deduplication key
webhook-timestampUnix timestamp of the delivery attempt
webhook-signatureHMAC-SHA256 signature. Verify before processing

Event Type Naming

Event type names follow the pattern:

{domain}.{resource}.{description}.{version}

Example: payer_enrollment.request.in_progress.v1

ComponentDescription
domainProduct area (e.g. payer_enrollment)
resourceEntity being described (e.g. request)
descriptionWhat happened (e.g. in_progress, blocked, terminal)
versionSchema version (e.g. v1)