Sign in
latestOpenAPI 3.1.02026-08-153864115.7 MB

c301132dbfd7

Cards

Card Updated

Sent when a card is updated

Required permissions:

  • webhook_receive:cards
postWebhookcard.updated

Headers

webhook-idstring required

A unique identifier for this webhook request

Example:msg_xxxxxxxxxxxxxxxxxxxxxxxx
webhook-signaturestring required

The signature of the webhook request with the webhook version prepended

Example:v1,BASE64ENCODEDSIGNATURE
webhook-timestampstring required

The timestamp in seconds since the Unix epoch that the webhook was sent at on the server

Example:1727606400

Payload

api_version'v1' required

The API version for this webhook

api_version_datestring nullable required

The dated API version (Api-Version-Date) the payload is serialized to

company_idstring nullable

The account ID that this webhook event is associated with

idstring required

A unique ID for every single webhook request

timestampstring date-time required

The timestamp in ISO 8601 format that the webhook was sent at on the server

type'card.updated' required

The webhook event type

Example payload

{
  "api_version": "v1",
  "api_version_date": "2026-07-20",
  "company_id": "biz_xxxxxxxxxxxxxx",
  "data": {
    "billing": {
      "city": "Austin",
      "country_code": "US",
      "line1": "4180 Burnet Rd",
      "line2": "Suite 210",
      "postal_code": "78756",
      "region": "TX"
    },
    "canceled_at": "2026-01-01T12:00:00.000Z",
    "created_at": "2026-01-01T12:00:00.000Z",
    "expiration_month": "12",
    "expiration_year": "2027",
    "id": "icrd_xxxxxxxxxxxxxx",
    "last4": "4242",
    "limit": {
      "amount": 50,
      "frequency": "daily"
    },
    "name": "Bay rent card",
    "object": "card",
    "secrets": {
      "card_number": "4242424242424242",
      "cvc": "123",
      "name_on_card": "Tanya Cole",
      "pin": "1234"
    },
    "spent_last_month": 1234,
    "status": "active",
    "type": "virtual",
    "user_id": "user_xxxxxxxxxxxxxx"
  },
  "id": "msg_xxxxxxxxxxxxxxxxxxxxxxxx",
  "timestamp": "2025-01-01T00:00:00.000Z",
  "type": "card.updated"
}

Response

Return a 200 status to indicate that the data was received successfully