# Swift message received

Triggered when a SWIFT message (e.g., [pacs.008](/guides/product/receive-money/incoming-transfer-notifications#example-pacs008-message-content)) is received and processed by Wise on behalf of a partner.
* Event type: `swift#message-received`
* Profile level subscriptions: Supported
* Application level subscriptions: Supported

Events may not be delivered in the order they occurred. Use `data.occurred_at` to reconcile the order.
See the [Event ordering guide](/guides/developer/webhooks/event-ordering) for details.
See the [Webhooks guide](/guides/developer/webhooks) for setup instructions, signature verification, and best practices.

Endpoint: POST swift#message-received
Version: 2026Q4

## Header parameters:

  - `X-Signature-SHA256` (string)
    RSA-SHA256 signature of the request body, Base64 encoded. Verify this against the [Wise public key](/guides/developer/webhooks/event-handling#requests) to ensure the request is authentic and has not been tampered with.

  - `X-Delivery-Id` (string)
    Unique identifier for this webhook delivery attempt.

  - `X-Test-Notification` (boolean)
    Present with the value `true` if this is a test notification sent to verify your callback URL during subscription setup.

## Request fields (application/json):

  - `schema_version` (string)
    Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook).
    Enum: "4.0.0"

  - `subscription_id` (string)
    ID of the webhook subscription that triggered this event.
    Example: 01234567-89ab-cdef-0123-456789abcdef

  - `event_type` (string)
    Event type identifier
    Example: swift#message-received

  - `sent_at` (string)
    Timestamp when the event was sent.
    Example: 2025-10-21T12:34:58.123Z

  - `data` (object)

  - `data.action` (object)

  - `data.action.id` (integer)
    The transfer ID of the incoming payment.
    Example: 12345

  - `data.action.profile_id` (integer)
    The profile ID of the incoming payment.
    Example: 222

  - `data.action.account_id` (integer)
    The balance account ID where funds will be deposited.
    Example: 333

  - `data.occurred_at` (string)
    Date and time at which the SWIFT message was processed by Wise. Time in UTC.
    Example: 2025-10-21T12:34:56.789Z

  - `data.resource` (object)

  - `data.resource.id` (string)
    Identifier of the SWIFT message.
    Example: a1b2c3d4e5f6

  - `data.resource.message_type` (string)
    Type of SWIFT message contained in the content field (e.g., `pacs.008.001.08`). Extensible for future message types.
    Example: pacs.008.001.08

  - `data.resource.content` (string)
    The raw SWIFT message data, encoded as specified by `content_encoding`.
    Example: PD94bWwgdmVyc2lvbj0iMS4wIj8+...

  - `data.resource.content_encoding` (string)
    The encoding applied to the content field. Always `base64`.
    Example: base64

## Response 200:

  - `200` (unknown)
    Return any `2xx` status to acknowledge receipt of the event.

## Response 200 fields (application/json):

  - `status` (string)
    Example: ok