Your flyer designs
Your OWN flyer designs (paginated/filterable) to attach with select_campaign_design. clientId is forced from your key — you only ever see your own designs. Filters: search, format, status, sortBy, sortDirection; page + limit. Notes: - Use a design’s `id` as designId in select_campaign_design. Composed from: flyer service getDesigns(clientId), clientId forced from key.clientId
Your OWN flyer designs (paginated/filterable) to attach with select_campaign_design. clientId is forced from your key — you only ever see your own designs. Filters: search, format, status, sortBy, sortDirection; page + limit.
Notes:
- Use a design’s
idas designId in select_campaign_design.
Composed from: flyer service getDesigns(clientId), clientId forced from key.clientId
Authorization
clientKey Your Oppizi client key. Send it as Authorization: Bearer <client-key>. Scoped to your client account only.
In: header
Query Parameters
Design-name/text search.
Filter by design status.
Response Body
application/json
curl -X GET "https://example.com/client/designs"{ "success": true, "data": { "designs": [ { "id": "812", "clientId": "450", "format": "POSTCARD_6X9", "status": "READY", "thumbnailUrl": "https://…/thumb.png" } ], "pagination": { "currentPage": 1, "totalPages": 1, "totalItems": 1 } }}Your audiences GET
Your OWN reusable ADM audiences to link with link_campaign_audience. Always scoped to your client (cross-client → 403). Paginate with first (≤500) + skip; filter by ids/statuses; search on name. Notes: - Use an audience’s `id` as audienceId in link_campaign_audience. Composed from: direct PG SELECT on "Audience", forced client_scope = key.clientId
Self-serve cities GET
Cities you can target in a self-serve campaign, with the fields needed for targeting: id, name, state, nameWithState, country, latitude, longitude. Only self-serve-enabled cities; ops-only fields (surge, pay, recruitment) are never exposed. Optional `search` on name; `first` (≤1000). Notes: - Pass rows as `selectedCities` to set_campaign_targeting when building a DM-core / H2H self-serve campaign. Composed from: direct PG SELECT on "City" (minimal geo/label columns) WHERE the city has a self-serve "Location" (Location.is_self_serve_location = true)