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

# Create team

`POST /v3/teams`

This endpoint creates a new team for an organization. It allows specifying team details, company information, and business settings to organize advertising campaigns and manage user access.

## Request body

- Authv3CreateTeamRequest
  - `team` Authv3Team, required
    - `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 created team

- Authv3CreateTeamResponse
  - `team` Authv3TeamResp
    - `id` string — The team's unique ID number.
    - `name` string — The name of the team.
    - `namespaceId` string — The organization or account group ID.
    - `companyName` string — 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'
    - `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 — 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.

## 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)