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
financial_connections.account.account_numbers_updated Linked account's numbers change
Identified by type field in the body
Resource financial_connections
{
"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
financial_connections.account.created
documented official schema
financial_connections.account.created Linked account created
Identified by type field in the body
Resource financial_connections
{
"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
financial_connections.account.deactivated
documented official schema
financial_connections.account.deactivated Linked account goes from active to inactive
Identified by type field in the body
Resource financial_connections
{
"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
financial_connections.account.disconnected
documented official schema
financial_connections.account.disconnected Linked account disconnected
Identified by type field in the body
Resource financial_connections
{
"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
financial_connections.account.reactivated
documented official schema
financial_connections.account.reactivated Linked account goes from inactive to active
Identified by type field in the body
Resource financial_connections
{
"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
financial_connections.account.refreshed_balance
documented official schema
financial_connections.account.refreshed_balance Linked account's balance refresh finishes, successfully or not
Identified by type field in the body
Resource financial_connections
{
"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
financial_connections.account.refreshed_ownership
documented official schema
financial_connections.account.refreshed_ownership Linked account's ownership refresh finishes, successfully or not
Identified by type field in the body
Resource financial_connections
{
"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
financial_connections.account.refreshed_transactions
documented official schema
financial_connections.account.refreshed_transactions Linked account's transaction refresh finishes, successfully or not
Identified by type field in the body
Resource financial_connections
{
"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
financial_connections.account.upcoming_account_number_expiry
documented official schema
financial_connections.account.upcoming_account_number_expiry Linked account's tokenized number will expire soon
Identified by type field in the body
Resource financial_connections
{
"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
financial_connections.account.expected_deactivation_date_updated
documented official schema
financial_connections.account.expected_deactivation_date_updated Linked account's expected deactivation date changes
Identified by type field in the body
Resource financial_connections
{
"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
financial_connections.account.supported_payment_method_types_updated
documented official schema
financial_connections.account.supported_payment_method_types_updated Payment method types a linked account supports change
Identified by type field in the body
Resource financial_connections
{
"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
financial_connections.account.upcoming_deactivation
documented official schema
financial_connections.account.upcoming_deactivation Linked account will soon become inactive
Identified by type field in the body
Resource financial_connections
{
"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
financial_connections.authorization.expected_deactivation_date_updated
documented official schema
financial_connections.authorization.expected_deactivation_date_updated Authorization's expected deactivation date changes
Identified by type field in the body
Resource financial_connections
{
"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
financial_connections.authorization.upcoming_deactivation
documented official schema
financial_connections.authorization.upcoming_deactivation Authorization will soon become inactive
Identified by type field in the body
Resource financial_connections
{
"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
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.