Prior authorization webhooks

Prior authorization webhooks notify your system about PA status or outcome updates, provider outreach, platform messages, and prescription transfer updates. See Webhooks to configure an endpoint and understand the shared delivery envelope, signature verification, retries, and processing guidance.

Webhook events

Event type	When it is sent	Payload
`prior_authorization.status_change`	A PA is created, its public status changes, or certain outcome information is updated.	Prior authorization
`prior_authorization.provider_outreach_change`	A provider outreach attempt is created or changes state, or its outreach sequence reaches a terminal state. This event is in beta; contact support to enable it.	Provider outreach
`prior_authorization.message`	A message is added to the PA’s message thread.	Prior authorization
`prior_authorization.prescription_transfer_change`	For a PA with an NDP submission that is approved or does not require prior authorization, the transfer to the preferred dispensing pharmacy starts or is updated after the PA is completed.	Prior authorization

Provider outreach and prescription transfer are conditional. You only receive events that are enabled for your webhook endpoint.

`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 Prior Authorization Response Handling 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.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.

`prior_authorization.prescription_transfer_change`

This event is part of the non-dispensing pharmacy (NDP) flow. When a PA with an NDP submission is completed with an approval or a determination that prior authorization is not required, Develop Health begins transferring the prescription to the preferred dispensing pharmacy. The event is sent when the initial transfer attempt is recorded and when subsequent transfer or confirmation activity updates the prescription transfer. The webhook’s data object contains the current PA resource. Inspect data.prescription_transfer for the transfer status, confirmation state, error code, transfer attempts, and confirmation attempts. Use GET /prior-authorization/ to retrieve the latest PA.

Getting Started

Benefit Verification