Webhook events

Every event a webhook can subscribe to, by area, with what it means.

Choose events when you add a webhook. Every event arrives in the same envelope, {id, type, apiVersion, createdAt, data}, signed with Standard Webhooks: Webhooks shows how to verify and handle it. More events can be added: answer one you do not handle with a 2xx.

Payouts

Event	What it means
treasury.payout.awaiting_approval	A person must approve this payout before anything is sent.
treasury.payout.completed	The payout settled; its transaction hash and explorer link are included when known.
treasury.payout.failed	The payout stopped as failed; read its outcome before trying again.
treasury.payout.cancelled	The payout was cancelled before anything was sent.

Fiat

Event	What it means
treasury.fiat_leg.planned	A bank payout is planned; nothing has been sent yet.
treasury.fiat_leg.awaiting_approval	The bank payout waits for your workspace’s approval before it is sent.
treasury.fiat_leg.payout_held	The bank payout waits before sending, for the reason its code names; it is asked again.
treasury.fiat_leg.dispatching	The venue was asked to send the bank payout; it has not reported it sent yet.
treasury.fiat_leg.uncertain	Whether the venue took the request is not known yet; it is checked, never sent again.
treasury.fiat_leg.in_transit	Reported sent by the venue; it has not been reported arrived.
treasury.fiat_leg.held_by_provider	The provider reports it is holding the bank payout.
treasury.fiat_leg.overdue	The bank payout passed its expected arrival time and is still being followed.
treasury.fiat_leg.manual_review	Support must look at this bank payout; it will not fail on its own.
treasury.fiat_leg.settled	Reported arrived by the venue, not independently verified.
treasury.fiat_leg.returned	Reported returned by the venue: the money came back to the account.
treasury.fiat_leg.returned_after_settlement	A bank payout reported arrived was later reported returned.
treasury.fiat_leg.refunding	The money is being returned to where it came from.
treasury.fiat_leg.refunded	The money was returned to where it came from.
treasury.fiat_leg.cancelled	A bank payout or deposit-first pay-in ended before anything moved; its outcome code says why.
treasury.fiat_leg.refused	The bank payout was refused before anything was sent; its code says why.
treasury.bank_deposit.declared	A member said they sent a bank deposit to a venue account; nothing is credited until it is confirmed.
treasury.bank_deposit.overdue	The declared deposit passed its expected arrival time; it is still credited when it lands.
treasury.bank_deposit.manual_review	The deposit could not be matched on its own; support must look at it.
treasury.bank_deposit.credited	The venue’s record, or the LP’s own report, credited the deposit; creditSource says which.
treasury.bank_deposit.withdrawn_by_user	The workspace said the deposit was not sent; nothing moved.
treasury.bank_deposit.history_unreadable	The venue’s deposit history can’t be read, so the deposit can’t be matched yet; nothing is lost.
treasury.bank_deposit.history_recovered	The venue’s deposit history can be read again and matching resumed.
treasury.fiat_leg.awaiting_funds	A deposit-first trade waits for its bank deposit; nothing converts before it lands.
treasury.fiat_leg.funds_received	The deposit landed; the trade runs only at the consented worst price or better.
treasury.fiat_leg.price_beyond_bound	The price moved or the worst price lapsed; confirmAgainReason says which. Nothing converted.
treasury.fiat_leg.expired_unfunded	The pay-by deadline passed before the deposit arrived.
treasury.fiat_leg.late_funds	The deposit arrived after its pay-by deadline.

Transfers

Event	What it means
treasury.transfer.submitted	The custodian accepted the transfer; it has not settled yet.
treasury.transfer.awaiting_approval	The transfer is waiting for your workspace’s approvers.
treasury.transfer.rejected	An approver rejected the transfer; nothing was sent.
treasury.transfer.completed	The custodian reports the transfer complete.
treasury.transfer.failed	The transfer failed; read its outcome before sending again.
treasury.transfer.cancelled	The transfer was cancelled.
treasury.transfer.custodian_approval_relayed	Your approval reached the custodian, which still decides the outcome.
treasury.transfer.expired	The approval window closed before the transfer was released.
treasury.transfer.replaced	A replacement transaction was recorded for the original transfer.
treasury.transfer.confirmation_threshold_set	A person changed how many confirmations this transfer waits for.

Runs

Event	What it means
treasury.run.draft	A plan was saved for review; nothing has been sent.
treasury.run.waiting_for_funds	Its sources cannot pay it yet; nobody is asked to approve it until they can.
treasury.run.awaiting_approval	The Run is waiting for a person to approve it.
treasury.run.ready	The Run is approved and about to start.
treasury.run.running	The Run is carrying out its plan.
treasury.run.waiting	The Run is waiting on something outside it, such as a confirmation.
treasury.run.reconciling	The original operation is being checked, not sent again.
treasury.run.needs_review	A person needs to look at the reason the Run stopped.
treasury.run.paused	The Run is paused; its reason says what resumes it.
treasury.run.succeeded	The Run finished its whole plan.
treasury.run.partially_succeeded	Part of the plan finished; check each step before acting.
treasury.run.failed	The Run failed; nothing more is sent without a person.
treasury.run.recovering	The Run is following its recorded recovery plan.
treasury.run.recovered	The recovery finished.
treasury.run.cancelled	The Run was cancelled before anything more was sent.

Run steps

Event	What it means
treasury.step.pending	The step has not started.
treasury.step.ready	The step is about to start.
treasury.step.dispatching	The step is sending its one operation.
treasury.step.waiting	The step is waiting for its operation to confirm.
treasury.step.reconciling	The original operation is being checked, not sent again.
treasury.step.needs_review	A person needs to look at the reason the step stopped.
treasury.step.paused	The step cannot continue until its pause is resolved.
treasury.step.succeeded	The step’s operation is confirmed.
treasury.step.partially_succeeded	Part of the step finished and needs reconciling.
treasury.step.failed	The step failed; check its outcome before retrying.
treasury.step.cancelled	The step was cancelled.
treasury.step.custodian_cancel_requested	The custodian accepted a person’s cancel of the step’s payment; the step settles from the custodian’s own record.
treasury.step.confirmation_threshold_set	A person changed how many confirmations the step’s custody payment waits for.
treasury.step.custodian_approval_relayed	A person’s approval of the step’s payment reached the custodian, which still decides the outcome.
treasury.step.custodian_cancel_overridden	The custodian completed the step’s payment after accepting its cancel; the step settles as sent at the custodian’s actual fee.

Approvals

Event	What it means
treasury.approval.requested	A treasury decision is waiting for an eligible member of the workspace.
treasury.approval.expiring	A treasury decision is still waiting and its approval window closes soon.
treasury.approval.approved	A member approved the request. Approval is not execution: nothing is implied about sending.
treasury.approval.denied	A member declined the request, so it will not go ahead.
treasury.approval.expired	Nobody decided before the approval window closed, so the request will not go ahead.

Destinations

Event	What it means
treasury.destination.retired	A person retired the Destination; it cannot receive new payouts.

Workspace

Event	What it means
treasury.workspace.frozen	Someone froze Treasury for the workspace; no money moves until it is unfrozen.

Balances

Event	What it means
treasury.balance.low	A balance fell below its alert threshold.
treasury.balance.recovered	A balance is back above its alert threshold.
treasury.statement.ready	A monthly statement for the previous month was generated and can be downloaded under current reporting access.

Automations

Event	What it means
treasury.automation.created	A person saved a new automation.
treasury.automation.updated	A person changed an automation’s definition.
treasury.automation.activated	The automation was approved and will start Runs on its schedule.
treasury.automation.returned_to_review	The automation needs approval again before it runs.
treasury.automation.paused	The automation will not start Runs until it is resumed.
treasury.automation.resumed	The automation starts Runs again.
treasury.automation.archived	The automation was archived and will not run again.

Agents

Event	What it means
treasury.agent.envelope.created	Spending limits were recorded for an agent.
treasury.agent.envelope.updated	An agent’s spending limits changed.
treasury.agent.kill_switch.activated	A person stopped the agent; it cannot move money until restarted.
treasury.agent.session_signer.granted	An agent was given a signer for its wallet.
treasury.agent.session_signer.revoked	An agent’s signer was taken away.
treasury.agent.sponsor.changed	A different member is now accountable for the agent.

Agent payments

Event	What it means
treasury.agent.payment.authorized	An agent’s payment was authorized; it has not settled yet.
treasury.agent.payment.settled	An agent’s payment settled.
treasury.agent.payment.refused	An agent’s payment was refused; its reason is recorded.
treasury.agent.payment.received	An agent received a payment.

Orders

Event	What it means
order.updated	An order or venue trade changed status; carries its id, new status and where to read it.

Settlement

Event	What it means
settlement.failed	A settlement attempt failed.
settlement.retried	A failed settlement is being attempted again.
settlement.disputed	A counterparty disputed a settlement.

Members

Event	What it means
member.invited	Someone was invited to the workspace.
member.joined	An invited person joined the workspace.
member.added	A member was added to the workspace.
member.removed	A member was removed from the workspace.

API keys

Event	What it means
api_key.rotated	An API key was replaced with a new secret.
api_key.revoked	An API key was revoked and no longer works.
api_key.expiring_soon	An API key will expire soon; rotate it to keep access.

Liquidity provision

Event	What it means
lp.enabled	A liquidity provider was enabled for the workspace.
lp.disabled	A liquidity provider was disabled for the workspace.
lp.sla_breach	A liquidity provider missed its service level.

Compliance

Event	What it means
kyb.expiring	The workspace’s business verification expires soon.
kyb.expired	The workspace’s business verification expired.
kyb.renewed	The workspace’s business verification was renewed.
kyc.expiring	A member’s identity verification expires soon.
compliance.sanctions.flag_added	A sanctions screening flag was added.
compliance.event	A compliance event without its own name was recorded.

Credit

Event	What it means
credit.updated	A credit line or limit changed.

Affiliation

Event	What it means
affiliation.invited	Another workspace was invited to affiliate.
affiliation.accepted	An affiliation invitation was accepted.
affiliation.revoked	An affiliation was ended.

Bilateral

Event	What it means
bilateral.requested	A counterparty asked to trade bilaterally.
bilateral.accepted	A bilateral trading request was accepted.

Direct users

Event	What it means
direct_user.created	A direct user was created under this broker.
direct_user.updated	A direct user’s details changed.
direct_user.invited	A direct user was invited.
direct_user.suspended	A direct user was suspended.
direct_user.verification.pending	A direct user’s verification is in progress.
direct_user.verification.verified	A direct user passed verification.
direct_user.verification.rejected	A direct user’s verification was rejected.

Wallets

Event	What it means
wallet.session_signer.granted	A session signer was granted on a workspace wallet.
wallet.session_signer.revoked	A session signer was revoked from a workspace wallet.

Webhooks

Event	What it means
webhook.subscription.paused	Another webhook in this workspace paused after repeated failed deliveries.