v5
latestOpenAPI 3.1.02026-07-262421791.5 MBwebhook-event
profile
Profile state change
Triggered every time a profile's state is updated.
- Event type: profiles#state-change
- Profile level subscriptions: Not 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.
postWebhookprofiles#state-change
Headers
X-Signature-SHA256string
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.
X-Delivery-Idstring uuid
Unique identifier for this webhook delivery attempt.
X-Test-Notificationboolean
Present with the value true if this is a test notification sent to verify your callback URL during subscription setup.
Payload
Example payload
{
"schema_version": "4.0.0",
"subscription_id": "f5b51f77-e14a-433b-9f7c-fc2834ffcff5",
"event_type": "profiles#state-change",
"sent_at": "2020-01-01T12:34:56.123Z",
"data": {
"resource": {
"id": 1234,
"type": "profile"
},
"current_state": "WITHDRAW_ONLY",
"occurred_at": "2020-01-01T12:34:56.789Z"
}
}Response
Return any 2xx status to acknowledge receipt of the event.
Example response
{
"status": "ok"
}