> ## Documentation Index
> Fetch the complete documentation index at: https://docs.develophealth.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Prior authorization webhooks

> Understand when prior authorization webhooks are sent.

Prior authorization webhooks notify your system about PA status or outcome
updates, provider outreach, platform messages, and prescription transfer
updates.

See [Webhooks](/api-reference/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](/api-reference/prior-authorization/get_item) |
| `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](/api-reference/provider-outreach-webhooks)     |
| `prior_authorization.message`                      | A message is added to the PA's message thread.                                                                                                                                              | [Prior authorization](/api-reference/prior-authorization/get_item) |
| `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](/api-reference/prior-authorization/get_item) |

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](/api-reference/prior-authorization/response-handling) for lifecycle
states, outcomes, and recommended handling.

The webhook's `data` object uses the
[GET /prior-authorization/{id}](/api-reference/prior-authorization/get_item)
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](/api-reference/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](/api-reference/prior-authorization/patch_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/{id}](/api-reference/prior-authorization/get_item) to
retrieve the latest PA.