Stripe: Create an Account Session

← Account sessions operations · Get started

Operation stripe.postaccountsessions

Provider route: POST /v1/account_sessions. Alter supplies the connection’s credentials and routing.

Call through Alter

Install @alter-ai/sdk @alter-ai/stripe with npm, or alter-sdk-stripe with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { StripeIntegration } from "@alter-ai/stripe";

async function execute(input: Parameters<StripeIntegration["accountSessions"]["postAccountSessions"]>[0]) {
  const app = new App({ apiKey: process.env.ALTER_API_KEY! });
  try {
    const provider = new StripeIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
    const call = await provider.accountSessions.postAccountSessions(input);
    const result = await call.wait();
    return result.bodyJson();
  } finally {
    await app.close();
  }
}

import os
from alter_sdk import App
from alter_sdk_stripe import StripeIntegration

async def execute(arguments):
    async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
        provider = StripeIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
        call = await provider.account_sessions.post_account_sessions(arguments)
        result = await call.wait()
        return result.body_json()

Input

Field	Type	Presence	Description and constraints
$	object	Root	Additional keys: not allowed
headers	object	Optional	Additional keys: not allowed
headers.Idempotency-Key	string	Optional	Minimum length: 1 Maximum length: 255
body	object	Required within parent	Additional keys: not allowed
body.account	string	Required within parent	The identifier of the account to create an Account Session for.
body.components	object	Required within parent	Each key of the dictionary represents an embedded component, and each embedded component maps to its configuration (e.g. whether it has been enabled or not).
body.components.account_management	object	Optional
body.components.account_management.enabled	boolean	Required within parent
body.components.account_management.features	object	Optional
body.components.account_management.features.disable_stripe_user_authentication	boolean	Optional
body.components.account_management.features.external_account_collection	boolean	Optional
body.components.account_onboarding	object	Optional
body.components.account_onboarding.enabled	boolean	Required within parent
body.components.account_onboarding.features	object	Optional
body.components.account_onboarding.features.disable_stripe_user_authentication	boolean	Optional
body.components.account_onboarding.features.external_account_collection	boolean	Optional
body.components.balance_report	object	Optional
body.components.balance_report.enabled	boolean	Required within parent
body.components.balance_report.features	object	Optional
body.components.balances	object	Optional
body.components.balances.enabled	boolean	Required within parent
body.components.balances.features	object	Optional
body.components.balances.features.disable_stripe_user_authentication	boolean	Optional
body.components.balances.features.edit_payout_schedule	boolean	Optional
body.components.balances.features.external_account_collection	boolean	Optional
body.components.balances.features.instant_payouts	boolean	Optional
body.components.balances.features.standard_payouts	boolean	Optional
body.components.disputes_list	object	Optional
body.components.disputes_list.enabled	boolean	Required within parent
body.components.disputes_list.features	object	Optional
body.components.disputes_list.features.capture_payments	boolean	Optional
body.components.disputes_list.features.destination_on_behalf_of_charge_management	boolean	Optional
body.components.disputes_list.features.dispute_management	boolean	Optional
body.components.disputes_list.features.refund_management	boolean	Optional
body.components.disputes_list.features.smart_disputes_management	boolean	Optional
body.components.documents	object	Optional
body.components.documents.enabled	boolean	Required within parent
body.components.documents.features	object	Optional
body.components.financial_account	object	Optional
body.components.financial_account.enabled	boolean	Required within parent
body.components.financial_account.features	object	Optional
body.components.financial_account.features.disable_stripe_user_authentication	boolean	Optional
body.components.financial_account.features.external_account_collection	boolean	Optional
body.components.financial_account.features.send_money	boolean	Optional
body.components.financial_account.features.transfer_balance	boolean	Optional
body.components.financial_account_transactions	object	Optional
body.components.financial_account_transactions.enabled	boolean	Required within parent
body.components.financial_account_transactions.features	object	Optional
body.components.financial_account_transactions.features.card_spend_dispute_management	boolean	Optional
body.components.instant_payouts_promotion	object	Optional
body.components.instant_payouts_promotion.enabled	boolean	Required within parent
body.components.instant_payouts_promotion.features	object	Optional
body.components.instant_payouts_promotion.features.disable_stripe_user_authentication	boolean	Optional
body.components.instant_payouts_promotion.features.external_account_collection	boolean	Optional
body.components.instant_payouts_promotion.features.instant_payouts	boolean	Optional
body.components.issuing_card	object	Optional
body.components.issuing_card.enabled	boolean	Required within parent
body.components.issuing_card.features	object	Optional
body.components.issuing_card.features.card_management	boolean	Optional
body.components.issuing_card.features.card_spend_dispute_management	boolean	Optional
body.components.issuing_card.features.cardholder_management	boolean	Optional
body.components.issuing_card.features.spend_control_management	boolean	Optional
body.components.issuing_cards_list	object	Optional
body.components.issuing_cards_list.enabled	boolean	Required within parent
body.components.issuing_cards_list.features	object	Optional
body.components.issuing_cards_list.features.card_management	boolean	Optional
body.components.issuing_cards_list.features.card_spend_dispute_management	boolean	Optional
body.components.issuing_cards_list.features.cardholder_management	boolean	Optional
body.components.issuing_cards_list.features.disable_stripe_user_authentication	boolean	Optional
body.components.issuing_cards_list.features.spend_control_management	boolean	Optional
body.components.notification_banner	object	Optional
body.components.notification_banner.enabled	boolean	Required within parent
body.components.notification_banner.features	object	Optional
body.components.notification_banner.features.disable_stripe_user_authentication	boolean	Optional
body.components.notification_banner.features.external_account_collection	boolean	Optional
body.components.payment_details	object	Optional
body.components.payment_details.enabled	boolean	Required within parent
body.components.payment_details.features	object	Optional
body.components.payment_details.features.capture_payments	boolean	Optional
body.components.payment_details.features.destination_on_behalf_of_charge_management	boolean	Optional
body.components.payment_details.features.dispute_management	boolean	Optional
body.components.payment_details.features.refund_management	boolean	Optional
body.components.payment_details.features.smart_disputes_management	boolean	Optional
body.components.payment_disputes	object	Optional
body.components.payment_disputes.enabled	boolean	Required within parent
body.components.payment_disputes.features	object	Optional
body.components.payment_disputes.features.destination_on_behalf_of_charge_management	boolean	Optional
body.components.payment_disputes.features.dispute_management	boolean	Optional
body.components.payment_disputes.features.refund_management	boolean	Optional
body.components.payment_disputes.features.smart_disputes_management	boolean	Optional
body.components.payment_method_settings	object	Optional
body.components.payment_method_settings.enabled	boolean	Required within parent
body.components.payment_method_settings.features	object	Optional
body.components.payment_method_settings.features.disable_stripe_user_authentication	boolean	Optional
body.components.payments	object	Optional
body.components.payments.enabled	boolean	Required within parent
body.components.payments.features	object	Optional
body.components.payments.features.capture_payments	boolean	Optional
body.components.payments.features.destination_on_behalf_of_charge_management	boolean	Optional
body.components.payments.features.dispute_management	boolean	Optional
body.components.payments.features.refund_management	boolean	Optional
body.components.payments.features.smart_disputes_management	boolean	Optional
body.components.payout_details	object	Optional
body.components.payout_details.enabled	boolean	Required within parent
body.components.payout_details.features	object	Optional
body.components.payout_reconciliation_report	object	Optional
body.components.payout_reconciliation_report.enabled	boolean	Required within parent
body.components.payout_reconciliation_report.features	object	Optional
body.components.payouts	object	Optional
body.components.payouts.enabled	boolean	Required within parent
body.components.payouts.features	object	Optional
body.components.payouts.features.disable_stripe_user_authentication	boolean	Optional
body.components.payouts.features.edit_payout_schedule	boolean	Optional
body.components.payouts.features.external_account_collection	boolean	Optional
body.components.payouts.features.instant_payouts	boolean	Optional
body.components.payouts.features.standard_payouts	boolean	Optional
body.components.payouts_list	object	Optional
body.components.payouts_list.enabled	boolean	Required within parent
body.components.payouts_list.features	object	Optional
body.components.tax_registrations	object	Optional
body.components.tax_registrations.enabled	boolean	Required within parent
body.components.tax_registrations.features	object	Optional
body.components.tax_settings	object	Optional
body.components.tax_settings.enabled	boolean	Required within parent
body.components.tax_settings.features	object	Optional
body.expand	array	Optional	Specifies which fields in the response should be expanded.
body.expand[]	string	Each item	Maximum length: 5000

Response

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

Field	Type	Presence	Description and constraints
$	Model	Root	Expand Create an Account Session — response body

Referenced models: Create an Account Session — response body

Schemas

18 more schemas are linked from the tables above, on the schema pages.

Create an Account Session — response body

Field	Type	Presence	Description and constraints
$	object	Root	An AccountSession allows a Connect platform to grant access to a connected account in Connect embedded components. We recommend that you create an AccountSession each time you need to display an embedded component to your user. Do not save AccountSessions to your database as they expire relatively quickly, and cannot be used more than once. Related guide: [Connect embedded components](https://docs.stripe.com/connect/get-started-connect-embedded-components)
account	string	Required within parent	The ID of the account the AccountSession was created for Maximum length: 5000
client_secret	string	Required within parent	The client secret of this AccountSession. Used on the client to set up secure access to the given `account`. The client secret can be used to provide access to `account` from your frontend. It should not be stored, logged, or exposed to anyone other than the connected account. Make sure that you have TLS enabled on any page that includes the client secret. Refer to our docs to [setup Connect embedded components](https://docs.stripe.com/connect/get-started-connect-embedded-components) and learn about how `client_secret` should be handled. Maximum length: 5000
components	Model	Required within parent	Expand Create an Account Session — response body — components
expires_at	JSON	Required within parent
expires_at (anyOf 1)	integer	Alternative	The timestamp at which this AccountSession will expire. Format: unix-time
expires_at (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
livemode	boolean	Required within parent	If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
object	string	Required within parent	String representing the object's type. Objects of the same type share the same value. Known values: account_session

Referenced models: Create an Account Session — response body — components

Create an Account Session — response body — components

Field	Type	Presence	Description and constraints
$	object	Root
account_management	Model	Required within parent	Expand Create an Account Session — response body — components account management
account_onboarding	Model	Required within parent	Expand Create an Account Session — response body — components account management
balance_report	Model	Required within parent	Expand Create an Account Session — response body — components documents
balances	Model	Required within parent	Expand Create an Account Session — response body — components payouts
disputes_list	Model	Required within parent	Expand Create an Account Session — response body — components payments
documents	Model	Required within parent	Expand Create an Account Session — response body — components documents
financial_account	Model	Required within parent	Expand Create an Account Session — response body — components financial account
financial_account_transactions	Model	Required within parent	Expand Create an Account Session — response body — components financial account transactions
instant_payouts_promotion	Model	Required within parent	Expand Create an Account Session — response body — components instant payouts promotion
issuing_card	Model	Required within parent	Expand Create an Account Session — response body — components issuing card
issuing_cards_list	Model	Required within parent	Expand Create an Account Session — response body — components issuing cards list
notification_banner	Model	Required within parent	Expand Create an Account Session — response body — components account management
payment_details	Model	Required within parent	Expand Create an Account Session — response body — components payments
payment_disputes	Model	Required within parent	Expand Create an Account Session — response body — components payment disputes
payment_method_settings	Model	Required within parent	Expand Create an Account Session — response body — components payment method settings
payments	Model	Required within parent	Expand Create an Account Session — response body — components payments
payout_details	Model	Required within parent	Expand Create an Account Session — response body — components documents
payout_reconciliation_report	Model	Required within parent	Expand Create an Account Session — response body — components documents
payouts	Model	Required within parent	Expand Create an Account Session — response body — components payouts
payouts_list	Model	Required within parent	Expand Create an Account Session — response body — components documents
tax_registrations	Model	Required within parent	Expand Create an Account Session — response body — components documents
tax_settings	Model	Required within parent	Expand Create an Account Session — response body — components documents

Referenced models: Create an Account Session — response body — components account management, Create an Account Session — response body — components documents, Create an Account Session — response body — components payments, Create an Account Session — response body — components financial account, Create an Account Session — response body — components financial account transactions, Create an Account Session — response body — components instant payouts promotion, Create an Account Session — response body — components issuing card, Create an Account Session — response body — components issuing cards list, Create an Account Session — response body — components payment disputes, Create an Account Session — response body — components payment method settings, Create an Account Session — response body — components payouts

Create an Account Session — response body — components account management

Field	Type	Presence	Description and constraints
$	object	Root
enabled	boolean	Required within parent	Whether the embedded component is enabled.
features	Model	Required within parent	Expand Create an Account Session — response body — components account management features

Referenced models: Create an Account Session — response body — components account management features

Create an Account Session — response body — components documents

Field	Type	Presence	Description and constraints
$	object	Root
enabled	boolean	Required within parent	Whether the embedded component is enabled.
features	Model	Required within parent	Expand Create a Payment Method — response body — zip

Referenced models: Create a Payment Method — response body — zip

Create an Account Session — response body — components payments

Field	Type	Presence	Description and constraints
$	object	Root
enabled	boolean	Required within parent	Whether the embedded component is enabled.
features	Model	Required within parent	Expand Create an Account Session — response body — components payments features

Referenced models: Create an Account Session — response body — components payments features

Create a Payment Method — response body — zip

Field	Type	Presence	Description and constraints
$	object	Root

Policy, approvals and errors

SDK function policy ID: stripe.postaccountsessions. Catalog operation: PostAccountSessions. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Pinned headers: {"Stripe-Version": "2026-09-30.endive"}

Official provider source