ads
POST /v1/ads/history-imports/{import_id}/seeds/{key}/accept
Accept one seeded Zinn® Ads setting (countries to start with, countries to exclude, target ROAS).
Authentication
Send an API key as a bearer token. The key must carry the ads.manage permission; a key without it is refused with 403, not 404.
This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.
Try it
Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.
curl -X POST https://api.zinndigital.com/v1/ads/history-imports/{import_id}/seeds/{key}/accept \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ }'Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console
Details
Gated on ads.manage; audit action ads.history_seed_accept. Writes the seed to the ad account's Zinn® Ads settings: start_countries ADDS its countries to the markets and removes none (OWNERFIX-A); a market is removed only when it is listed in drop, and only a country in the seed's value.drop (spent, nothing back) can be (422 badDrop otherwise). The seed records added and dropped, as does the audit entry. excluded_countries adds to the customer's own exclusion list, roas_target_pct sets the ROAS target. An account seed is approved in the change queue instead; it answers 422 noSuchSeed.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
import_id (path) | string | Yes | — |
key (path) | string<start_countries, excluded_countries, roas_target_pct> | Yes | — |
Request body
| Name | Type | Required | What it is |
|---|---|---|---|
drop | string[] | No | start_countries only: the markets the person ticked to remove, each from the seed's value.drop. |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
id | string | Yes | — |
connection_id | string | Yes | — |
source_connection_id | object | Yes | — |
revenue_source | string<first_party, csv, none> | Yes | — |
window_start | string | Yes | — |
window_end | string | Yes | — |
currency | string | Yes | — |
thresholds | AdsHistoryThresholds | Yes | History-import thresholds (za-159, docs/1006 §80); the Recommended defaults when returned as recommended. |
months_read | integer | Yes | — |
months_total | integer | Yes | — |
status | string<queued, reading, done, failed> | Yes | — |
error | string | Yes | Why a failed import stopped, e.g. sourceNotYours, notInGoodStanding, sourceNeedsReconnect. |
evidence | object | Yes | — |
seeds | AdsHistorySeed[] | Yes | — |
created_at | string | Yes | — |
finished_at | object | Yes | — |
Errors this endpoint can return
401 · 403 · 404 · 422 · 429