v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Accounts

Create transaction banking account

Creates a transaction banking account. For details, refer to Transaction banking accounts.

This endpoint generates the following events:

For more information about events and setting up event notifications, refer to the Data and reporting overview guide.

post/corporate/v1/corporate-accounts

Request body

division_codestring required

Code used to identify your division within the organization. Division code should only contain letters, numbers, and hyphens.

program_idnumber required

Pismo program ID.

external_account_idstring required

Custom account ID. Used as the key for all operations (manage accounts, transactions, etc.) on the corporate layer.

This field is:

Unique within the Organization
Immutable: The field cannot be updated.
Not recyclable: You can't reuse an external account ID, even if the account that was using it has been canceled.

parent_account_idinteger

Parent account ID. If provided, the account is the child of the account referenced by parent_account_id. The account referenced by parent_account_id can be in another program or division.

account_creation_datetimestring date-time

The datetime the account was created (in UTC). The datetime format follows the ISO 8601 standard: yyyy-mm-ddThh:mm:ss.sssZ.<br> minLength: 24 maxLength: 24

currency_codestring

ISO 4217 3-letter currency code, For example, 986 = Brazilian real and 840 = US dollar.

Example request

{
  "division_code": "US",
  "program_id": 1010,
  "applicant": {
    "document_number": "7777888hh",
    "name": "Chester Fields",
    "external_id": "ABC123456"
  },
  "external_account_id": "b993ba96-b3e8-4ef7-9cf7-7eee5ddafdab",
  "parent_account_id": 232,
  "account_creation_datetime": "2025-02-01T22:07:58.000Z",
  "overdraft": {
    "limit": 15680.45
  },
  "currency_code": "840"
}

Response

Account created

account_idinteger required

Account ID

program_idinteger required

Program ID. This is a client-provided ID.

external_account_idstring

Custom account ID. Used as the key for all operations (manage accounts, transactions, etc.) on the corporate layer.

This field is:

Unique within the Organization
Immutable: The field cannot be updated.
Not recyclable: You can't reuse an external account ID, even if the account that was using it has been canceled.

division_codestring

Code used to identify your division within the organization. Division code should only contain letters, numbers, and hyphens.

Example response

{
  "account_id": 6912345,
  "program_id": 2222,
  "external_account_id": "b993ba96-b3e8-4ef7-9cf7-7eee5ddafdab",
  "division_code": "US"
}