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

# Create teams in bulk

`POST /v2/teams/bulk/create`

This endpoint creates bulk team for an organization using new v3 version logic in the background. It allows specifying team details, company information, and business settings to organize advertising campaigns and manage user access. Note: When a supplier attempts to create records in bulk, the API allows a maximum of 50 records per request. If the request contains more than 50 records, the API returns an error message indicating that the limit has been exceeded.

## Request body

- V2CreateBulkTeamRequest
  - `teams` Authv3Team[]
    - `id` string, required — The team's unique ID number.
    - `name` string, required — The name of the team.
    - `namespaceId` string, required — The organization or account group ID.
    - `companyName` string, required — The name of the company to which the team belongs.
    - `companyWebsite` string — The company website URL.
    - `companyPhone` string — The company phone number.
    - `companyAddress` Authv3CompanyAddress
      - `addressLine` string — The business street address.
      - `postcode` string — The business postal or ZIP code.
    - `companyType` 'COMPANY_TYPE_RETAILER' | 'COMPANY_TYPE_MANUFACTURER', required
    - `industryType` 'INDUSTRY_TYPE_GROCERY' | 'INDUSTRY_TYPE_PHARMACEUTICALS' | 'INDUSTRY_TYPE_PET_SUPPLIES' | 'INDUSTRY_TYPE_LIQUOR' | 'INDUSTRY_TYPE_ELECTRONICS' | 'INDUSTRY_TYPE_HARDWARE' | 'INDUSTRY_TYPE_FASHION' | 'INDUSTRY_TYPE_OTHER', required
    - `logoId` string — The company logo ID.
    - `businessIdentifier` string — The business registration number or license ID (requirements vary by country).
    - `reviewerEmail` string — The email address to be notified when a campaign requires review or when there is information about a low wallet balance. This field is applicable only to the Primary Retailer team.
    - `sellerId` string — The unique seller ID provided by the retailer.
    - `modifyTime` string, date-time — The timestamp indicating when the team was last modified.
    - `onBehalfOf` string — Specifies the entity responsible for funding advertisements, as required by local laws, such as the Digital Services Act in Europe.

## Response `200`

The bulk created team

- V2BulkTeamResponse
  - `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)