Create team - v3

This endpoint enables the creation of teams within an organization to streamline campaign management and user access. In version 3, direct user assignment via userIds has been removed. Users must be i

Epsilon Retail Media's documentation is now centralized with our knowledgebase!

For up to date guides, please view this page in the new Partner APIs space of our documentation.

---

description: "This endpoint enables the creation of teams within an organization to streamline campaign management and user access. In version 3, direct user assignment via userIds has been removed. Users must be invited through a dedicated invite flow, enhancing control and traceability. Use this endpoint to specify team details, company information, and business settings to organize advertising campaigns and manage access permissions effectively."

Create team - v3

Create team

post

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.

Authorizations

AuthorizationstringRequired

For accessing the API a valid JWT jwt must be passed in all queries in the 'Authorization' header. The following syntax must be used in the 'Authorization' header. (Bearer xxx.yyy.zzz)

Body

Responses

200

The created team

application/json

400

There was a problem with input.

application/json

401

Login failed or token not valid.

application/json

403

Access denied due to insufficient permissions.

application/json

default

An unexpected error response.

application/json

post/v3/teams

POST /v3/teams HTTP/1.1
Host: auth.<env>.citrusad.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 509

{
  "team": {
    "businessIdentifier": "biz_AB12345",
    "companyAddress": {
      "addressLine": "123 Main St",
      "postcode": "12345"
    },
    "companyName": "Innovative Solutions Ltd.",
    "companyPhone": "[phone]",
    "companyType": "COMPANY_TYPE_RETAILER",
    "companyWebsite": "https://www.innovativesolutions.com",
    "industryType": "INDUSTRY_TYPE_GROCERY",
    "logoId": "logo_567XYZ",
    "name": "Development Team",
    "namespaceId": "namespace_ABC123",
    "onBehalfOf": "Ad Sponsor Ltd.",
    "reviewerEmail": "[e-mail]",
    "sellerId": "seller_990XYZ"
  }
}

{
  "team": {
    "businessIdentifier": "biz_AB12345",
    "companyAddress": {
      "addressLine": "123 Main St",
      "postcode": "12345"
    },
    "companyName": "Innovative Solutions Ltd.",
    "companyPhone": "[phone]",
    "companyType": "COMPANY_TYPE_RETAILER",
    "companyWebsite": "https://www.innovativesolutions.com",
    "id": "team_001XYZ",
    "industryType": "INDUSTRY_TYPE_GROCERY",
    "logoId": "logo_567XYZ",
    "modifyTime": "2024-02-14T23:45:01Z",
    "name": "Development Team",
    "namespaceId": "namespace_ABC123",
    "onBehalfOf": "Ad Sponsor Ltd.",
    "reviewerEmail": "[e-mail]",
    "sellerId": "seller_990XYZ"
  }
}