Stripe financial_connections webhook events

Stripe sends 14 financial_connections events, including financial_connections.account.account_numbers_updated, financial_connections.account.created and financial_connections.account.deactivated.

Every event here can also reach agents as an MCP event through Hookdeck: MCP events →

financial_connections.account.account_numbers_updated

documented official schema

Linked account's numbers change

Identified by type field in the body Resource financial_connections

stripe-financial-connections-account-account-numbers-updated.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "account_holder": { … },
      "balance": { … },
      "balance_refresh": { … },
      "category": "cash",
      "created": 1234567890,
      "display_name": "Sample Checking Account",
      "id": "fca_1Pgc76B7WZ01zgkWqlYVCIub",
      "institution_name": "StripeBank",
      "last4": "6789",
      "livemode": false,
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "financial_connections.account.account_numbers_updated"
}

Key fields

Field Type Example
data.object.id string fca_1Pgc76B7WZ01zgkWqlYVCIub
data.object.status string active
data.object.created integer 1234567890

Full schema: 49 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

financial_connections.account.created

documented official schema

Linked account created

Identified by type field in the body Resource financial_connections

stripe-financial-connections-account-created.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "account_holder": { … },
      "balance": { … },
      "balance_refresh": { … },
      "category": "cash",
      "created": 1234567890,
      "display_name": "Sample Checking Account",
      "id": "fca_1Pgc76B7WZ01zgkWqlYVCIub",
      "institution_name": "StripeBank",
      "last4": "6789",
      "livemode": false,
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "financial_connections.account.created"
}

Key fields

Field Type Example
data.object.id string fca_1Pgc76B7WZ01zgkWqlYVCIub
data.object.status string active
data.object.created integer 1234567890

Full schema: 49 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

financial_connections.account.deactivated

documented official schema

Linked account goes from active to inactive

Identified by type field in the body Resource financial_connections

stripe-financial-connections-account-deactivated.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "account_holder": { … },
      "balance": { … },
      "balance_refresh": { … },
      "category": "cash",
      "created": 1234567890,
      "display_name": "Sample Checking Account",
      "id": "fca_1Pgc76B7WZ01zgkWqlYVCIub",
      "institution_name": "StripeBank",
      "last4": "6789",
      "livemode": false,
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "financial_connections.account.deactivated"
}

Key fields

Field Type Example
data.object.id string fca_1Pgc76B7WZ01zgkWqlYVCIub
data.object.status string active
data.object.created integer 1234567890

Full schema: 49 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

financial_connections.account.disconnected

documented official schema

Linked account disconnected

Identified by type field in the body Resource financial_connections

stripe-financial-connections-account-disconnected.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "account_holder": { … },
      "balance": { … },
      "balance_refresh": { … },
      "category": "cash",
      "created": 1234567890,
      "display_name": "Sample Checking Account",
      "id": "fca_1Pgc76B7WZ01zgkWqlYVCIub",
      "institution_name": "StripeBank",
      "last4": "6789",
      "livemode": false,
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "financial_connections.account.disconnected"
}

Key fields

Field Type Example
data.object.id string fca_1Pgc76B7WZ01zgkWqlYVCIub
data.object.status string active
data.object.created integer 1234567890

Full schema: 49 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

financial_connections.account.reactivated

documented official schema

Linked account goes from inactive to active

Identified by type field in the body Resource financial_connections

stripe-financial-connections-account-reactivated.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "account_holder": { … },
      "balance": { … },
      "balance_refresh": { … },
      "category": "cash",
      "created": 1234567890,
      "display_name": "Sample Checking Account",
      "id": "fca_1Pgc76B7WZ01zgkWqlYVCIub",
      "institution_name": "StripeBank",
      "last4": "6789",
      "livemode": false,
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "financial_connections.account.reactivated"
}

Key fields

Field Type Example
data.object.id string fca_1Pgc76B7WZ01zgkWqlYVCIub
data.object.status string active
data.object.created integer 1234567890

Full schema: 49 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

financial_connections.account.refreshed_balance

documented official schema

Linked account's balance refresh finishes, successfully or not

Identified by type field in the body Resource financial_connections

stripe-financial-connections-account-refreshed-balance.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "account_holder": { … },
      "balance": { … },
      "balance_refresh": { … },
      "category": "cash",
      "created": 1234567890,
      "display_name": "Sample Checking Account",
      "id": "fca_1Pgc76B7WZ01zgkWqlYVCIub",
      "institution_name": "StripeBank",
      "last4": "6789",
      "livemode": false,
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "financial_connections.account.refreshed_balance"
}

Key fields

Field Type Example
data.object.id string fca_1Pgc76B7WZ01zgkWqlYVCIub
data.object.status string active
data.object.created integer 1234567890

Full schema: 49 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

financial_connections.account.refreshed_ownership

documented official schema

Linked account's ownership refresh finishes, successfully or not

Identified by type field in the body Resource financial_connections

stripe-financial-connections-account-refreshed-ownership.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "account_holder": { … },
      "balance": { … },
      "balance_refresh": { … },
      "category": "cash",
      "created": 1234567890,
      "display_name": "Sample Checking Account",
      "id": "fca_1Pgc76B7WZ01zgkWqlYVCIub",
      "institution_name": "StripeBank",
      "last4": "6789",
      "livemode": false,
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "financial_connections.account.refreshed_ownership"
}

Key fields

Field Type Example
data.object.id string fca_1Pgc76B7WZ01zgkWqlYVCIub
data.object.status string active
data.object.created integer 1234567890

Full schema: 49 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

financial_connections.account.refreshed_transactions

documented official schema

Linked account's transaction refresh finishes, successfully or not

Identified by type field in the body Resource financial_connections

stripe-financial-connections-account-refreshed-transactions.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "account_holder": { … },
      "balance": { … },
      "balance_refresh": { … },
      "category": "cash",
      "created": 1234567890,
      "display_name": "Sample Checking Account",
      "id": "fca_1Pgc76B7WZ01zgkWqlYVCIub",
      "institution_name": "StripeBank",
      "last4": "6789",
      "livemode": false,
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "financial_connections.account.refreshed_transactions"
}

Key fields

Field Type Example
data.object.id string fca_1Pgc76B7WZ01zgkWqlYVCIub
data.object.status string active
data.object.created integer 1234567890

Full schema: 49 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

financial_connections.account.upcoming_account_number_expiry

documented official schema

Linked account's tokenized number will expire soon

Identified by type field in the body Resource financial_connections

stripe-financial-connections-account-upcoming-account-number-expiry.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "account_holder": { … },
      "balance": { … },
      "balance_refresh": { … },
      "category": "cash",
      "created": 1234567890,
      "display_name": "Sample Checking Account",
      "id": "fca_1Pgc76B7WZ01zgkWqlYVCIub",
      "institution_name": "StripeBank",
      "last4": "6789",
      "livemode": false,
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "financial_connections.account.upcoming_account_number_expiry"
}

Key fields

Field Type Example
data.object.id string fca_1Pgc76B7WZ01zgkWqlYVCIub
data.object.status string active
data.object.created integer 1234567890

Full schema: 49 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

financial_connections.account.expected_deactivation_date_updated

documented official schema

Linked account's expected deactivation date changes

Identified by type field in the body Resource financial_connections

stripe-financial-connections-account-expected-deactivation-date-updated.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "account_holder": { … },
      "balance": { … },
      "balance_refresh": { … },
      "category": "cash",
      "created": 1234567890,
      "display_name": "Sample Checking Account",
      "id": "fca_1Pgc76B7WZ01zgkWqlYVCIub",
      "institution_name": "StripeBank",
      "last4": "6789",
      "livemode": false,
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "financial_connections.account.expected_deactivation_date_updated"
}

Key fields

Field Type Example
data.object.id string fca_1Pgc76B7WZ01zgkWqlYVCIub
data.object.status string active
data.object.created integer 1234567890

Full schema: 49 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

financial_connections.account.supported_payment_method_types_updated

documented official schema

Payment method types a linked account supports change

Identified by type field in the body Resource financial_connections

stripe-financial-connections-account-supported-payment-method-types-updated.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "account_holder": { … },
      "balance": { … },
      "balance_refresh": { … },
      "category": "cash",
      "created": 1234567890,
      "display_name": "Sample Checking Account",
      "id": "fca_1Pgc76B7WZ01zgkWqlYVCIub",
      "institution_name": "StripeBank",
      "last4": "6789",
      "livemode": false,
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "financial_connections.account.supported_payment_method_types_updated"
}

Key fields

Field Type Example
data.object.id string fca_1Pgc76B7WZ01zgkWqlYVCIub
data.object.status string active
data.object.created integer 1234567890

Full schema: 49 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

financial_connections.account.upcoming_deactivation

documented official schema

Linked account will soon become inactive

Identified by type field in the body Resource financial_connections

stripe-financial-connections-account-upcoming-deactivation.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "account_holder": { … },
      "balance": { … },
      "balance_refresh": { … },
      "category": "cash",
      "created": 1234567890,
      "display_name": "Sample Checking Account",
      "id": "fca_1Pgc76B7WZ01zgkWqlYVCIub",
      "institution_name": "StripeBank",
      "last4": "6789",
      "livemode": false,
      "status": "active"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "financial_connections.account.upcoming_deactivation"
}

Key fields

Field Type Example
data.object.id string fca_1Pgc76B7WZ01zgkWqlYVCIub
data.object.status string active
data.object.created integer 1234567890

Full schema: 49 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

financial_connections.authorization.expected_deactivation_date_updated

documented official schema

Authorization's expected deactivation date changes

Identified by type field in the body Resource financial_connections

stripe-financial-connections-authorization-expected-deactivation-date-updated.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "object": "financial_connections.authorization",
      "id": "obj_123",
      "institution_name": "institution_name",
      "livemode": true,
      "status": "active",
      "status_details": { … }
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "financial_connections.authorization.expected_deactivation_date_updated"
}

Key fields

Field Type Example
data.object.id string obj_123
data.object.status string active

Full schema: 18 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

financial_connections.authorization.upcoming_deactivation

documented official schema

Authorization will soon become inactive

Identified by type field in the body Resource financial_connections

stripe-financial-connections-authorization-upcoming-deactivation.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "object": "financial_connections.authorization",
      "id": "obj_123",
      "institution_name": "institution_name",
      "livemode": true,
      "status": "active",
      "status_details": { … }
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "financial_connections.authorization.upcoming_deactivation"
}

Key fields

Field Type Example
data.object.id string obj_123
data.object.status string active

Full schema: 18 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

Route Stripe events by type.

Event Gateway receives every Stripe delivery and filters and routes it by event type, so each service gets only the events it handles.

Not affiliated with Stripe. Facts are compiled from public sources and linked inline.