---
title: "Create wallets in bulk"
method: POST
path: "/v2/wallets/bulk/create"
tags: ["BulkWalletOperations"]
---

# Create wallets in bulk

`POST /v2/wallets/bulk/create`

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.

## Request body

- V2BulkCreateWalletRequest
  - `wallets` V2Wallet[], required — The bulk create request containing the wallet model.
    - `id` string — The wallet identifier.
    - `namespaceId` string, required — The namespace identifier that associates the wallet with a team.
    - `teamId` string, required — The unique team identifier assigned for the wallet.
    - `name` string, required — The wallet name.
    - `externalId` string — The optional external ID field for storing custom identifiers such as Placement IO numbers, purchase order numbers, or Salesforce numbers for tracking purposes. Partners can use this field to associate external identifiers with the wallet. Must be shorter than 255 characters.
    - `currencyCode` string, required — The wallet currency code using the 3-letter ISO 4217 standard.
    - `dailyBudget` string — The daily spending limit for the wallet.

## Response `200`

Details of the created wallets.

- V2BulkCreateWalletResponse
  - `bulkId` string — Unique identifier for the bulk operation.
  - `status` 'BULK_OPERATION_SUBMITTED' | 'BULK_OPERATION_IN_PROGRESS' | 'BULK_OPERATION_COMPLETED' | 'BULK_OPERATION_FAILED'
  - `message` string — Status message or result description for the bulk operation.

## Other responses

- `400` — There was a problem with input.
- `401` — Login failed or token not valid.
- `403` — Access denied due to insufficient permissions.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/citrusad/apis/citrus-auth-api.md) · [All operations](https://skmtc.net/citrusad/apis/citrus-auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/citrusad/citrus-auth-api/revisions/a040003c7378/schema)