Create a webhook subscription
Create a webhook subscription
Subscribes an HTTPS callback to the calling account’s events.
Deliveries are signed: X-Webhook-Signature = hex(HMAC-SHA256(secret, timestamp + "." + body)) with the timestamp in X-Webhook-Timestamp. Up to 5 attempts with incremental backoff.
POST
Create a webhook subscription
Authorizations
Session JWT (from register/login) or API key (pk_...).
X-API-Key: <token> is accepted as an alternative header.
Body
application/json
Available options:
payin_credited, payin_expired, payout_status_changed, transfer_received, crypto_deposit_credited, crypto_deposit_held, crypto_deposit_alert, crypto_withdrawal_status_changed, banking_customer_status_changed, banking_operation_status_changed, aml_screening_updated, kyc_verification_status_changed, kyb_verification_status_changed, kyc_link_completed, kyb_link_completed, kyc_document_validated, kyb_document_validated, kyc_liveness_completed, wallet_deposit_received, wallet_send_status_changed, wallet_key_exported, * HTTPS only; localhost and private IPs are rejected.
Minimum string length:
16Last modified on July 18, 2026