PEpeec
Products

Create Global Brand

Create a brand and return its id — pass it as a product's global_brand_id when creating products. The returned name is the brand's canonical name and may differ slightly from the name you sent. This is separate from POST /brands, which creates a brand a project tracks for AI-visibility reporting.

post/global-brands

Request

  • Base URL
    https://api.peec.ai/customer/v1
  • URL
    https://api.peec.ai/customer/v1/global-brands
  • Auth
    • API key in header X-API-Key
    • or API key in query parameter api_key
    • or HTTP bearer

Request body

project_idstring

Required if using a company api key

namestring required

The brand name.

Example request

{
  "project_id": "or_f45b94ba-5e35-4982-93ed-285e72ee14eb",
  "name": "Nike"
}

Response

The brand

idstring uuid required

The global_brand_id — pass this as a product's brand when creating products.

namestring required

The brand's canonical name. May differ slightly from the name you sent, since an existing brand is reused where one is found.

Example response

{
  "id": "019ecb6e-d030-7222-b531-b371fe9db583",
  "name": "Nike"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.