{
  "slug": "stripe-financial-connections-sessions-can-relink-deactivated-accounts-0ea9a31eb3cd",
  "title": "Stripe Financial Connections Sessions can relink deactivated accounts",
  "tools": [
    "stripe"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-01-28T00:00:00.000Z",
  "announced_at": "2026-01-28T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When an account or authorization’s `status_details.inactive.action` indicates relinking is available, create a Financial Connections Session for its authorization, optionally targeting one account. After the flow, inspect `relink_result` for success or authentication failure.",
    "examples": [
      "curl https://api.stripe.com/v1/financial_connections/sessions \\\n  -u \"<SECRET_KEY>:\" \\\n  -H \"Stripe-Version: 2026-01-28.preview\" \\\n  -d \"account_holder[type]\"=customer \\\n  -d \"account_holder[customer]\"=<CUSTOMER_ID> \\\n  -d \"permissions[]\"=payment_method \\\n  -d \"relink_options[authorization]\"=<AUTHORIZATION_ID>",
      "curl https://api.stripe.com/v1/financial_connections/sessions \\\n  -u \"<SECRET_KEY>:\" \\\n  -H \"Stripe-Version: 2026-01-28.preview\" \\\n  -d \"account_holder[type]\"=customer \\\n  -d \"account_holder[customer]\"=<CUSTOMER_ID> \\\n  -d \"permissions[]\"=payment_method \\\n  -d \"relink_options[authorization]\"=<AUTHORIZATION_ID> \\\n  -d \"relink_options[account]\"=<ACCOUNT_ID>"
    ],
    "gotchas": [
      "relink_options.authorization (required): Authorization to relink.",
      "relink_options.account: Account to relink; it must belong to the specified authorization. Set this with `relink_options.authorization` to target one account.",
      "account_holder (required): Account holder to link accounts for; the `type` child is required, and the `customer` child is available when type is `customer`.",
      "permissions (required): Requested data features; documented values include `balances`, `transactions`, `ownership`, and `payment_method`.",
      "status_details.inactive.action: Indicates the action, if any, for relinking an inactive authorization; `relink_required` means the user may complete the streamlined relink flow; `none` means no action is currently recommended.",
      "relink_result: Session result indicating whether the expected authorization was relinked or authentication failed, as stated in the release note.",
      "Prerequisite: Create a Stripe Customer before creating the session; the docs show `POST /v1/customers` with a name and email.",
      "Prerequisite: Use the `2026-01-28.preview` Stripe API version for the documented request.",
      "Relinking is for Financial Connections Accounts deactivated due to authentication issues or account changes at the financial institution.",
      "Use `relink_options.authorization` to relink all accounts belonging to a specific authorization; pass both `relink_options.authorization` and `relink_options.account` to relink a specific account.",
      "The `transactable` status applies to accounts for previously deactivated Tokenized Account Numbers."
    ]
  },
  "why_it_matters": "When updating a Financial Connections integration to reconnect a deactivated account, create a session configured for the authorization or account to relink and handle its result.",
  "sources": [
    "https://docs.stripe.com/changelog/clover/2026-01-28/financial-connections-relink",
    "https://docs.stripe.com/api/financial_connections/sessions/create?api-version=2026-01-28.preview",
    "https://docs.stripe.com/api/financial_connections/authorizations/object?api-version=2026-01-28.preview"
  ],
  "rank": 0.9803,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave1b-tools-20261017",
    "verdict_id": "wave1b-tools-20261017:wave1b-tools-20261017-42f0dd1b3af8934b-0:gate",
    "evidence_hash": "e9629595621d728c4b6b278a21982aec337f011acea0b894c3509c6955a7d914"
  },
  "review": {
    "draft_hash": "d62ba161c24fc39b466050b5b3490946c074e11f2e5e250a2a87b2d41f3d376e",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-tools-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.98 >= 0.9; 2 needed) and Jev gave 0.72 (>= 0.6 needed)."
  }
}