campaigns

Set geo targeting

One call for the whole location set. Send either the structured geoTargets array, or friendly include, exclude and radii lists of place names that the server resolves for you, plus the campaign-level locationIntent (who counts as being in a place).

Rules:

  • An empty geoTargets is valid and means "serve everywhere".
  • A radius circle cannot be excluded; exclude a named area instead.
  • A set made only of exclusions is rejected.

Pass dry_run: true to get the resolved rows and a plain-language sentence describing the effective targeting, without changing the campaign. Changes reach the ad platforms on the next sync.

Errors

  • 404 NOT_FOUND: no campaign with this id in the active Space.
  • 400 RADIUS_EXCLUSION_UNSUPPORTED: a radius row was marked negative.
  • 400 ONLY_EXCLUSIONS: every row is an exclusion.
  • 400 VALIDATION_ERROR: the body failed validation; details.issues[] names each field.
post/api/v1/campaigns/{id}/geo-targeting

Request

  • Base URL: https://api.growomat.com
  • URL: https://api.growomat.com/api/v1/campaigns/{id}/geo-targeting
  • Auth: HTTP bearer

Path parameters

idstring required

The campaign id.

Headers

X-Space-Idstring

The Space to work in, for example spc_8f3aK2. Omit it to use your personal Space. List your Spaces returns the ids. A Space that does not exist returns 404 SPACE_NOT_FOUND; one you are not a member of returns 403 NOT_A_MEMBER.

Request body

locationIntent'PRESENCE' | 'PRESENCE_OR_INTEREST'

Who counts as being in the targeted places. See CampaignCreate.locationIntent.

dry_runboolean

When true, preview the resolved set and the sentence without changing the campaign.

Response

OK. The result is in data. List responses also carry meta with nextCursor and total.

dataunknown required

Changes

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