{
  "id": "evt_wth001",
  "type": "withdrawal.created",
  "data": {
    "sideshiftAccountId": "user_a1b2c3d4",
    "externalId": "ext_user_456",
    "amountCents": 25000,
    "feeCents": 0,
    "netAmountCents": 25000,
    "currency": "usd",
    "paymentId": "wdrl_abc123",
    "status": "requested",
    "metadata": {
      "withdrawalId": "wdrl_abc123",
      "speed": "standard",
      "destinationInfo": "Chase Bank •••1234",
      "withdrawalCreatedAt": "2026-05-11T10:30:00.000Z"
    }
  },
  "timestamp": "2026-05-11T10:30:00.000Z"
}

Withdrawalcreated

Sent once when a user initiates a withdrawal from their SideShift account to an external payout method.

Mirrors the upstream withdrawal.created event from the underlying payment processor.

Routing

The event fans out to every integrator that has previously settled a completed transfer to this user (embed_transfers.toAccountId == userId with status == 'completed'). The integrator set is resolved once per withdrawal and cached, so all subsequent withdrawal.updated events for the same withdrawal go to the same audience without re-resolving.

Status enum

WEBHOOK

withdrawal.created

{
  "id": "evt_wth001",
  "type": "withdrawal.created",
  "data": {
    "sideshiftAccountId": "user_a1b2c3d4",
    "externalId": "ext_user_456",
    "amountCents": 25000,
    "feeCents": 0,
    "netAmountCents": 25000,
    "currency": "usd",
    "paymentId": "wdrl_abc123",
    "status": "requested",
    "metadata": {
      "withdrawalId": "wdrl_abc123",
      "speed": "standard",
      "destinationInfo": "Chase Bank •••1234",
      "withdrawalCreatedAt": "2026-05-11T10:30:00.000Z"
    }
  },
  "timestamp": "2026-05-11T10:30:00.000Z"
}

Authorizations

x-api-key

string

header

required

Your SideShift Connect API key (sk_live_* or sk_test_*). Generate from Settings → Connect.

Body

application/json

string

Unique event ID (use for deduplication)

type

string

Example:

"withdrawal.created"

data

object

Show child attributes

timestamp

string<date-time>

Response

200

Webhook acknowledged

⌘I