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

# Event types

PaySway webhook events are organized by model types, where each event type follows the format `MODEL.ACTION`.
This structure helps you understand which part of the system triggered the event and what action occurred.

## Available events

| Model type  | Event types                                                                                                                     |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `RECIPIENT` | [`RECIPIENT_CREATED`](#recipient-created), [`RECIPIENT_UPDATED`](#recipient-updated), [`RECIPIENT_DELETED`](#recipient-deleted) |

## Event types by model

The following sections document each event type.
Each event object is nested within the standard webhook [payload structure](/webhooks/implement-handler#payload-structure), with unique data in the `object` field containing event-specific information.

### RECIPIENT

Events related to Beneficiary Hub recipient management and lifecycle operations.

<AccordionGroup>
  <Accordion title="RECIPIENT_CREATED">
    Triggered when an end-user successfully adds a new recipient.

    For detailed field definitions, see [API Reference](/api-reference/beneficiary-hub/recipient-events).

    ```json Example theme={null}
    {
      "id": "ed110f81-efab-434a-ba5f-0efcf5f11eeb",
      "externalUserId": "c6fd6330-6932-4678-abf8-600fe155909c"
    }
    ```
  </Accordion>

  <Accordion title="RECIPIENT_UPDATED">
    Triggered when an end-user modifies any recipient information, including setting a new default recipient.

    For detailed field definitions, see [API Reference](/api-reference/beneficiary-hub/recipient-events).

    ```json Example theme={null}
    {
      "id": "ed110f81-efab-434a-ba5f-0efcf5f11eeb",
      "externalUserId": "d937f855-de7a-49dc-99ca-7d5f9f1f39e2"
    }
    ```
  </Accordion>

  <Accordion title="RECIPIENT_DELETED">
    Triggered when an end-user removes a recipient.

    For detailed field definitions, see [API Reference](/api-reference/beneficiary-hub/recipient-events).

    ```json Example theme={null}
    {
      "id": "ed110f81-efab-434a-ba5f-0efcf5f11eeb",
      "externalUserId": "a70ea3bb-c677-4af5-9ee3-ff11f96cb433"
    }
    ```
  </Accordion>
</AccordionGroup>
