Create a first-party audience

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.

post/audiences

Request

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

Request body

platform'meta' | 'google' | 'tiktok' | 'linkedin' | 'reddit' | 'apple' | 'bing' | 'chatgpt' | 'snapchat' required
kind'website_visitors' | 'website_event' | 'purchasers' | 'leads' | 'engagement' | 'lookalike' required
eventNamestring

Pixel event for website_event / purchasers / leads.

retentionDaysinteger

Membership window; platform default when omitted.

seedAudienceIdstring

Existing audience id to seed a lookalike.

lookalikeRationumber

Lookalike reach, 0.01–0.2 (1%–20%).

reasonstring

Response

An equivalent audience already existed and is returned

Changes

No recorded changes to this operation across all 1 revision of this API.