Overview

Medallion webhooks let you receive real-time notifications when events occur in the platform, without polling the API. When an event fires, Medallion sends an HTTP POST to your registered endpoint with a signed JSON payload.

Common use cases include:

Triggering downstream workflows when a payer enrollment reaches a terminal state
Updating your internal systems with real-time enrollment status without polling
Alerting your team when an enrollment is blocked and needs attention
Reconciling your records against Medallion's enrollment state

How It Works

You register an HTTPS endpoint in the Medallion platform
You subscribe to the event types you care about
When a matching event occurs, Medallion delivers a signed payload to your endpoint
You verify the signature and process the event

Delivery Guarantees

Property	Behavior
Delivery	At-least-once. The same event may arrive more than once.
Ordering	Not guaranteed. Use `updated_at` in the payload for sequencing.
Idempotency	Use the `webhook-id` request header as a deduplication key

Prerequisites

Webhooks are available to customer accounts with the Webhooks product enabled. Contact your Medallion account manager to enable access.