Event types

The catalog below covers card, transaction, and expense-report events. Expand an event to inspect its standard-envelope field types and an example payload.

Card events

card_creation.event

Emitted when a new card is created.

Payload fields

string

required

Always card_creation.event.

string

required

The per-endpoint notification id. It remains stable across delivery retries; deduplicate deliveries by this value.

string

required

The id of the entity that triggered the event.

string<date-time>

required

When the event occurred.

Example payload

{
  "event": "card_creation.event",
  "eventId": "<string>",
  "entityId": "c_example",
  "eventTimestamp": "2023-11-07T05:31:56Z"
}

card.delete

Emitted when a card is closed.

Payload fields

string

required

Always card.delete.

string

required

The per-endpoint notification id. It remains stable across delivery retries; deduplicate deliveries by this value.

string

required

The id of the entity that triggered the event.

string<date-time>

required

When the event occurred.

Example payload

{
  "event": "card.delete",
  "eventId": "<string>",
  "entityId": "c_example",
  "eventTimestamp": "2023-11-07T05:31:56Z"
}

card.update

Emitted when a card is activated, paused, or unpaused. A new card can emit this immediately after its creation event.

Payload fields

string

required

Always card.update.

string

required

The per-endpoint notification id. It remains stable across delivery retries; deduplicate deliveries by this value.

string

required

The id of the entity that triggered the event.

string<date-time>

required

When the event occurred.

Example payload

{
  "event": "card.update",
  "eventId": "<string>",
  "entityId": "c_example",
  "eventTimestamp": "2023-11-07T05:31:56Z"
}

Transaction events

aggregated_transaction.create

Emitted when a Transaction first appears in the transaction feed.

Payload fields

string

required

Always aggregated_transaction.create.

string

required

The per-endpoint notification id. It remains stable across delivery retries; deduplicate deliveries by this value.

string

required

The id of the entity that triggered the event.

string<date-time>

required

When the event occurred.

Example payload

{
  "event": "aggregated_transaction.create",
  "eventId": "<string>",
  "entityId": "agg_tx_example",
  "eventTimestamp": "2023-11-07T05:31:56Z"
}

aggregated_transaction.update

Emitted when an existing Transaction changes status or displayed details. The same Transaction can emit this event more than once.

Payload fields

string

required

Always aggregated_transaction.update.

string

required

The per-endpoint notification id. It remains stable across delivery retries; deduplicate deliveries by this value.

string

required

The id of the entity that triggered the event.

string<date-time>

required

When the event occurred.

Example payload

{
  "event": "aggregated_transaction.update",
  "eventId": "<string>",
  "entityId": "agg_tx_example",
  "eventTimestamp": "2023-11-07T05:31:56Z"
}

Expense report events

expense_report.create

Emitted when a new expense report is created.

Payload fields

string

required

Always expense_report.create.

string

required

The per-endpoint notification id. It remains stable across delivery retries; deduplicate deliveries by this value.

string

required

The id of the entity that triggered the event.

string<date-time>

required

When the event occurred.

Example payload

{
  "event": "expense_report.create",
  "eventId": "<string>",
  "entityId": "expense_report_example",
  "eventTimestamp": "2023-11-07T05:31:56Z"
}

expense_report.update

Emitted when an existing expense report changes, including updates to its status or editable report details.

Payload fields

string

required

Always expense_report.update.

string

required

The per-endpoint notification id. It remains stable across delivery retries; deduplicate deliveries by this value.

string

required

The id of the entity that triggered the event.

string<date-time>

required

When the event occurred.

Example payload

{
  "event": "expense_report.update",
  "eventId": "<string>",
  "entityId": "expense_report_example",
  "eventTimestamp": "2023-11-07T05:31:56Z"
}

Get started

Concepts

Money movement

Webhooks

Reference

Card events

Transaction events

Expense report events

​Card events

​Transaction events

​Expense report events

Card events

Transaction events

Expense report events