Webhook events
Subscribe your webhook endpoint to the events your integration uses. Provider
outreach events require the beta feature to be enabled.
prior_authorization.status_change
This event is sent when a PA is first created, when its public status changes,
and for certain outcome updates. It does not represent every workflow step.
Always inspect the current data.status and data.outcome instead of inferring
a specific action from the event alone.
See PA statuses, outcomes, and errors for lifecycle
states, outcomes, and recommended handling.
The webhook’s data object uses the
GET /prior-authorization/
response schema. Use that endpoint to retrieve the latest complete PA.
prior_authorization.coverage_assessment
This opt-in event is sent once when data.coverage_assessment becomes available
for a PA. Contact Develop Health to enable coverage assessments for your
organization. The data object uses the PA response schema.
The assessment stays fixed after publication. Continue using
prior_authorization.status_change, data.status, and data.outcome to track
the PA’s progress and result. Assessment and status webhooks are delivered
independently and can arrive in either order.
prior_authorization.provider_outreach_change
This beta event is sent when a provider outreach attempt is created or changes
state, or when its outreach sequence reaches a terminal state. It uses a
dedicated provider-outreach payload rather than the PA resource payload.
See Provider outreach webhooks for
the payload contract, attempt and sequence states, retries, parallel channels,
and transmitted content.
prior_authorization.message
This event is sent whenever a message is added to the PA’s platform message
thread. Inspect data.message_thread for the current thread and its messages.
The data field contains the PA resource, not only the new message.