Disbursements

Disbursement succeeded

Triggered when the acceptance.disbursement.succeeded webhook event is emitted. Your API will receive a POST request at the webhook URL you configured.

postWebhookacceptanceDisbursementSucceeded

Payload

eventIdstring uuid required

Unique identifier for this webhook event. Use this for idempotency.

timestampstring date-time required

When this event occurred (ISO 8601 format).

eventType'acceptance.disbursement.succeeded' required

The type of webhook event.

Example payload

{
  "eventType": "acceptance.disbursement.succeeded",
  "eventId": "234f5678-f90c-23e4-b567-537725285111",
  "timestamp": "2026-04-17T17:05:00Z",
  "data": {
    "disbursementId": "disbursement_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
    "source": {
      "accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
      "asset": "usdc"
    },
    "target": {
      "coinbaseUserId": "coinbase_user_abc123"
    },
    "amount": "25.00",
    "asset": "usdc",
    "status": "succeeded",
    "reason": "Goodwill disbursement for delayed shipment.",
    "externalReferenceId": "disbursement-2026-04-1234",
    "onchainTransactions": [
      {
        "transactionHash": "0xabc123def456789012345678901234567890abcdef1234567890abcdef123456",
        "network": "base"
      }
    ],
    "createdAt": "2026-04-17T17:00:00.000Z",
    "updatedAt": "2026-04-17T17:05:00.000Z"
  }
}

Response

Webhook received and processed successfully.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.