# Swift message received

Triggered when a SWIFT message (e.g., pacs.008) 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 for details.

See the Webhooks guide for setup instructions, signature verification, and best practices.

Endpoint: POST swift#message-received

## Header parameters:

  - `X-Signature-SHA256` (string)
    RSA-SHA256 signature of the request body, Base64 encoded. Verify this against the Wise public key to ensure the request is authentic and has not been tampered with.
    Example: "t7FMhk3OARMgwqz0LJXO..."

  - `X-Delivery-Id` (string)
    Unique identifier for this webhook delivery attempt.
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

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

## Request fields (application/json):

  - `body` (any)
    - `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 fields (application/json):

  - `status` (string)
    Example: "ok"