Create wallets in bulk

This endpoint allows you to create multiple wallets at once within your organization (up to 1,000). You can set up wallet details including names, currency settings, spending limits, and team assignments.

post/v2/wallets/bulk/create

Request

Base URL
https://auth.<env>.citrusad.com
Auth
none declared
TypeScript
https://skmtc.dev/citrusad/apis/citrus-auth-api/docs/v2/wallets/bulk/create/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

Example request

{
  "wallets": [
    {
      "id": "wallet_12345ABC",
      "namespaceId": "namespace_xyz987",
      "teamId": "team_456DEF",
      "name": "MainCompanyWallet",
      "externalId": "ext_789GHI",
      "currencyCode": "USD",
      "dailyBudget": "1000.00"
    }
  ]
}

Response

Details of the created wallets.

bulkIdstring

Unique identifier for the bulk operation.

status'BULK_OPERATION_SUBMITTED' | 'BULK_OPERATION_IN_PROGRESS' | 'BULK_OPERATION_COMPLETED' | 'BULK_OPERATION_FAILED'

messagestring

Status message or result description for the bulk operation.

Changes

No recorded changes to this operation across all 1 revision of this API.