---
title: "Create team"
method: POST
path: "/v2/teams"
tags: ["team"]
---

# Create team

`POST /v2/teams`

## Request body

- V2CreateTeamRequest
  - `team` V2Team, required
    - `id` string, required — The unique identifier of the team.
    - `name` string — The name of the team.
    - `namespaceId` string, required — The unique identifier of the namespace.
    - `companyName` string — The name of the company to which the team belongs.
    - `companyWebsite` string — The URL of the company's website.
    - `companyPhone` string — The phone number of the company to which the team belongs.
    - `companyAddress` V2CompanyAddress
      - `addressLine` string — The primary address line, typically including the street address.
      - `postcode` string — The postal code for the address.
    - `companyType` 'COMPANY_TYPE_RETAILER' | 'COMPANY_TYPE_MANUFACTURER'
    - `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'
    - `logoId` string — A unique identifier for the logo associated with the team.
    - `userIds` string[] — The unique identifiers of the users belonging to the team.
    - `businessIdentifier` string — A unique identifier used for various business-related purposes, such as a registration number, business license, or company house number. The specific identifier required may vary depending on the country or region where your company is located.
    - `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 — An ID unique to a supplier or merchant that is provided by a Retailer. Ensure the ID entered matches what your retailer has provided.
    - `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 created team

- V2CreateTeamResponse
  - `team` V2CTeamResp
    - `id` string — The unique identifier of the team.
    - `name` string — The name of the team.
    - `namespaceId` string — The unique identifier of the namespace.
    - `companyName` string — The name of the company to which the team belongs.
    - `companyWebsite` string — The URL of the company's website.
    - `companyPhone` string — The phone number of the company to which the team belongs.
    - `companyAddress` V2CompanyAddress
      - `addressLine` string — The primary address line, typically including the street address.
      - `postcode` string — The postal code for the address.
    - `companyType` 'COMPANY_TYPE_RETAILER' | 'COMPANY_TYPE_MANUFACTURER'
    - `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'
    - `logoId` string — A unique identifier for the logo associated with the team.
    - `userIds` string[] — The unique identifiers of the users belonging to the team.
    - `businessIdentifier` string — A unique identifier used for various business-related purposes, such as a registration number, business license, or company house number. The specific identifier required may vary depending on the country or region where your company is located.
    - `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 — An ID unique to a supplier or merchant that is provided by a Retailer. Ensure the ID entered matches what your retailer has provided.
    - `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.

## Other responses

- `400` — There was a problem with input.
- `401` — Login failed or token not valid.
- `403` — Login failed or token not valid.
- `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/versions/a040003c7378/schema)