---
title: "Create a first-party audience"
method: POST
path: "/audiences"
---

# Create a first-party audience

`POST /audiences`

## Request

- Base URL: `https://lazyads.ai/api/v1`
- URL: `https://lazyads.ai/api/v1/audiences`
- Auth: HTTP bearer

Creates a website-visitor, pixel-event, purchaser, lead, page-engagement, or lookalike audience on the connected ad account (Meta, TikTok, Snapchat, Google where the platform API allows it). An equivalent existing audience is returned instead of duplicating it (200); a new audience returns 201. Recorded in the Activity Log.

## Request body

- object
  - `platform` 'meta' | 'google' | 'tiktok' | 'linkedin' | 'reddit' | 'apple' | 'bing' | 'chatgpt' | 'snapchat', required
  - `kind` 'website_visitors' | 'website_event' | 'purchasers' | 'leads' | 'engagement' | 'lookalike', required
  - `eventName` string: Pixel event for website_event / purchasers / leads.
  - `retentionDays` integer: Membership window; platform default when omitted.
  - `seedAudienceId` string: Existing audience id to seed a lookalike.
  - `lookalikeRatio` number: Lookalike reach, 0.01–0.2 (1%–20%).
  - `reason` string

## Response `200`

An equivalent audience already existed and is returned

## Other responses

- `201`: Audience created
- `400`: Unsupported kind for this platform, missing pixel/seed, or seed too small

---

[API](https://skmtc.dev/lazyads/apis/lazyads-api.md) · [All operations](https://skmtc.dev/lazyads/apis/lazyads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lazyads/apis/lazyads-api/revisions/7d5de42538e9?raw)