Layers
Partner APIAPI referenceAds

PATCH /v1/projects/:projectId/ads/:platform/adsets/:adsetId/targeting

Update an adset's targeting (geo, age, custom audiences, placements).

View as Markdown
PATCH/v1/projects/:projectId/ads/{platform}/adsets/:adsetId/targeting
Phase 1stable
Auth
Bearer
Scope
ads:write:creative

Updates targeting on an adset. Targeting shapes vary materially per platform — Layers exposes a normalized partial-update view. For platform-native edge cases, use the granular per-platform fields.

Body

Body (all optional — partial update)
  • geo
    string[]optional
    ISO-3166-1 alpha-2 country codes. Example: `["US", "CA"]`.
  • age
    objectoptional
    `{ min, max }` integer ages. Platform clamping applies (Meta min 18, etc.).
  • genders
    string[]optional
    `male | female | all`.
  • customAudiences
    string[]optional
    Platform-specific custom-audience ids. Layers does not validate against the platform; passes through.
  • placements
    string[]optional
    Platform-specific placement strings.

Authority: gated by the creative axis (adset targeting is treated as creative-axis on the bucket-mode model — it's a "what does the customer see" change, not a budget/structural one).

See also

PATCH /v1/projects/:projectId/ads/:platform/adsets/:adsetId/budget

Update an adset's daily or lifetime budget. Cents universally.

PATCH /v1/projects/:projectId/ads/:platform/adsets/:adsetId/schedule

Update an adset's start/end time, dayparting.

On this page

BodySee also