---
title: "Create agreement signing session"
method: POST
path: "/platform/v1/customers/agreement/sessions"
tags: ["Customers"]
---

# Create agreement signing session

`POST /platform/v1/customers/agreement/sessions`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/platform/v1/customers/agreement/sessions`
- Auth: none declared
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/platform/v1/customers/agreement/sessions/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a session for customers to agree to the conditions and requirements.

:::warning
Before calling this endpoint, make sure you are not onboarding customers from restricted jurisdictions. For more information, see [BVNK Acceptable Use Policy](https://help.bvnk.com/hc/en-us/articles/11100445499666-BVNK-Acceptable-Use-Policy-Financial-Crime).
::: 

:::info Customers API v2
The [new customer onboarding flow](../../../get-started/create-embedded-partner-customer/create-customers-com) is recommended for all new integrations.

If you already have an existing integration with Customers API v1, you can continue using it. BVNK will continue to support this API going forward.
:::

:::warning Use with Customers v1
This endpoint is part of the Agreements v1 flow and must be used together with [Customers v1 endpoints](/bvnk/api-explorer/endpoints/create-customer). Customers created via Customers v2 use a different agreements flow.
:::

## Request body

- object
  - `customerType` 'COMPANY' | 'INDIVIDUAL', required: Type of customer
  - `countryCode` string, required: Country code of the customer's address in the ISO 3166-1 alpha-2 format.
  - `useCase` 'STABLECOIN_PAYOUTS' | 'EMBEDDED_STABLECOIN_WALLETS' | 'EMBEDDED_FIAT_ACCOUNTS' | 'CARD_AGREEMENT', required: Type of product to which the customer agreement applies.
  - `customerReference` string: Unique reference of the customer for whom the agreement session is being created.

## Response `200`

Agreement session created successfully

- object
  - `reference` string: Unique session identifier.
  - `status` 'PENDING' | 'SIGNED' | 'DECLINED': Session status. - `PENDING`: The session is pending and the agreements have not been signed yet. - `SIGNED`: The agreement has been signed by the customer. - `DECLINED`: The customer has declined the agreement.
  - `customerType` string: Type of customer. - `INDIVIDUAL`: A natural person. - `COMPANY`: A legal entity.
  - `useCase` string: Type of product to which the customer agreement applies. - `STABLECOIN_PAYOUTS`: Enables sending stablecoin payments to customers' crypto wallets from fiat or crypto balances. - `EMBEDDED_STABLECOIN_WALLETS`: Allows partners to create and manage stablecoin wallets for their customers to facilitate crypto transactions. - `EMBEDDED_FIAT_ACCOUNTS`: Enables creating virtual accounts with unique vIBANs for customers to send, hold, and receive fiat funds. - `CARD_AGREEMENT`: Enables issuing virtual cards linked to customer wallets.
  - `countryCode` string: Country code of the customer's address in the ISO 3166-1 alpha-2 format.
  - `expiresOn` string, date-time: Session expiration (ISO8601 timestamp)
  - `agreements` object[]
    - `name` string: Agreement identifier
    - `displayName` string: Public-facing title of the agreeement
    - `description` string: Agreement details
    - `url` string, uri: URL for agreement document
    - `status` string: Session status of the agreement signing
    - `privacyPolicyName` string: Privacy policy title
    - `privacyPolicyDescription` string: Privacy policy details
    - `privacyPolicyUrl` string, uri: URL to privacy policy

## Other responses

- `401`: Unauthorized

## Changes

- **2026-11-06** `c386d436bf2c`: 2 info
  - added the new optional request property `customerReference`
  - added the new `CARD_AGREEMENT` enum value to the request property `useCase`

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/platform/v1/customers/agreement/sessions/post.md)

---

[API](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints.md) - [All operations](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/revisions/28a1a9bc94df?raw)