Set up Spend webhooks

To receive real-time notifications when card expenses or reimbursements are updated, set up webhooks for Spend events. Complete the steps in this document.

Webhooks send callbacks for asynchronous updates, so your system stays in sync without polling the API.

Before you begin

• Have an active Airwallex account with access to the Developer settings in the Airwallex web app.
• Have a publicly accessible HTTPS endpoint ready to receive webhook events.

Create a webhook subscription

To subscribe to Spend webhook events, complete these steps:

1. Log in to the Airwallex web app.
2. Navigate to Developer > Webhooks.
3. Click + New subscription.
4. Enter the URL of your webhook endpoint.
5. Select the API version. Use the latest API version, or at minimum version 2025-11-11.
6. Select the Spend events you want to receive. For a full list of available events, see Spend webhook event types.
7. Click Save to activate the subscription.

Verify webhook signatures

Airwallex signs every webhook event with a signature you can verify to confirm it was sent by Airwallex and not a third party. For instructions on verifying webhook signatures, see Listen for webhook events.

Next steps

Now that you have configured Spend webhooks, refer to these related guides:

• Spend webhook event types
• Listen for webhook events
• Get your card expenses