Work with brands

An organization API key can access multiple brands. List them before creating or browsing brand-owned resources:

curl https://makelocalads.com/api/v1/brands \
  --header "Authorization: Bearer $LOCALADS_API_KEY"

{
  "data": [
    {
      "id": "1423f915-beca-4c53-a5e4-7c8c99537be9",
      "name": "Example Beauty",
      "slug": "example-beauty",
      "website_url": "https://example.com",
      "created_at": "2026-07-20T10:00:00.000Z",
      "updated_at": "2026-07-20T10:00:00.000Z"
    }
  ]
}

Use the returned id as brand_id when creating a product or listing products and templates.

Create a brand

If the brand you need is not in the list, create it. Products must belong to a brand, so this is the first call for a website LocalAds has not seen before.

curl --request POST \
  --url https://makelocalads.com/api/v1/brands \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: 8f0a1c2e-quenzy-setup" \
  --data '{
    "name": "Quenzy",
    "website_url": "https://thequenzy.com",
    "selling_countries": ["IN"]
  }'

{
  "id": "9f2b7c41-58a0-4c3e-9d61-2f0c8b7d4a15",
  "name": "Quenzy",
  "slug": "quenzy",
  "website_url": "https://thequenzy.com",
  "created_at": "2026-08-12T10:00:00.000Z",
  "updated_at": "2026-08-12T10:00:00.000Z"
}

name is the only required field. website_url is what LocalAds uses to fetch the logo, and selling_countries takes ISO 3166-1 alpha-2 codes. One brand per website: posting a second brand for a domain that already has one returns 409 brand_website_exists with the existing brand’s name, so retrying a setup script does not litter the account with duplicates. Send an Idempotency-Key to make a network retry safe as well.

Status	Code	Meaning
409	`brand_website_exists`	A brand for this website already exists. List brands and reuse its ID
422	`brand_limit_reached`	The plan’s brand allowance is used up

You do not need to send brand_id when retrieving a resource by its ID. Photoshoot creation also omits it because LocalAds derives the brand from the selected product and requires the template to belong to that same brand.

Last modified on August 12, 2026

Start here

Build with LocalAds

Help

Create a brand

​Create a brand

Create a brand