ads

POST /v1/ads/connections/{connection_id}/warm-start/end

End a new ad account's learning period early.

All ads endpoints

All developer docs →

Zinn®, our Viking, hammering at his anvil beside an API endpoint sending events to several listeners.

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/connections/{connection_id}/warm-start/end \
  -H "Authorization: Bearer zdk_live_…"

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

za-264. Gated on ads.manage; audit action ads.warm_start_end. A new Google connection learns for 14 days (warm_start_until): its automatic changes are proposed for a person, and no bid-strategy switch is made by itself. Ending it sends the automatic changes by themselves from now on, each with its Undo. Refuses notInWarmStart when the account is not learning. Returns the connection.

Parameters

NameTypeRequiredWhat it is
connection_id (path)stringYes—

Response

NameTypeRequiredWhat it is
rsa_testsbooleanYesRSATEST (za-197) — RSA A/B tests in the daily audit: the two ads of an ad group rotate evenly, a winner is called only at rsa_test_confidence_pct with the minimum data, and the…
rsa_test_confidence_pctintegerYesRSATEST (za-197) — the confidence a winner needs (p below 1 - this/100). Recommended 95.
rsa_test_min_impressionsintegerYesRSATEST (za-197) — impressions EACH variant needs before any verdict. Recommended 1000.
rsa_test_min_clicksintegerYesRSATEST (za-197) — clicks EACH variant needs before any verdict. Recommended 50.
rsa_test_min_daysintegerYesRSATEST (za-197) — days measured (from the day rotation is even) before any verdict. Recommended 14.
rsa_test_metricstring<ctr, conversions>YesRSATEST (za-197) — clicks per impression, or conversions per impression. Recommended ctr.
rsa_test_recommendedAdsRsaTestSettingsYesRSATEST (za-197) — the Recommended value of each rsa_test* setting ("Reset to recommended").
reach_min_searchesintegerYesza-86 (PARITY86) — the measured monthly searches a phrase needs before it broadens a campaign that cannot enter the auction (added as a PHRASE keyword through the keywords…
reach_test_daysintegerYesza-86 (PARITY86) — days of the reach test after a broadening; still no impression at the end → paused (Automatic pauses) or offered as one click (Ask me first). Recommended 14.
reach_recommendedAdsReachSettingsYesza-86 (PARITY86) — the Recommended value of each reach_* setting ("Reset to recommended").
waste_threshold_minorobjectYesWASTEFIX r3 (za-79, owner 2026-10-30 "they should be able to edit all things like this with their own values and we honour it") — the spend, in minor units of the account…
cluster_min_termsobjectYesWASTEFIX r3 (za-79) — how many small searches that never converted must share a word before that word is blocked as a cluster negative. null = the recommended 5, the default.
focus_min_conversionsobjectYesADSFOCUS-GUARD (za-258) — the conversions the account's enabled primary actions must record in 30 days before a Google campaign bidding for clicks is moved to Maximise conversions…
conversion_lag_daysobjectYesPARITY-B (za-93) — the customer's own trial or sales window in days: a sales verdict waits for trials and leads still inside it (counted pending, never "no sale"). null = sales…
cta_wordsstring[]YesPARITY-B (za-92) — the words a landing-page button must say ("Book a call"); an ad whose page has no button saying any of them is an lp_cta_wrong finding. [] = not checked, the…
free_plan_campaignsstring[]Yesza-251 (NEGPLAN): the Google campaign ids whose product has a free plan or free listing — the customer's tickbox. Those campaigns get no "free" starter negatives and a "free"…
offer_profilesobjectYesOFFERFIT (docs/1006.d/features/za-261-offerfit.md): per Google campaign id, what the campaign sells. auto is the profile the daily audit read from its ads, keywords and landing…
excluded_countriesstring[]YesZWASTE1 (za-175): countries this account never serves (ISO 3166-1 alpha-2). Each day every enabled campaign that does not already exclude one gets it as a negative location,…
country_waste_modestring<auto, suggest, off>YesZWASTE1 (za-175 / za-176): countries that spent with no FIRST-PARTY outcome (an activation, a real install, a real domain live, a sale — never a platform sign-up or trial) over 60…
country_cut_onbooleanYesCOUNTRYCUT (owner 2026-10-30, docs/1006 §COUNTRYCUT) — on by default. Inside an enabled campaign that serves several countries, a country with no sale is excluded from THAT…
country_cut_window_daysintegerYesThe customer's window; recommended 14.
country_cut_spend_minorobjectYesSpend with no sale that cuts a country, in account-currency minor units. null = the recommended £25 converted at today's stored rate (country_cut_recommended).
country_cut_share_pctintegerYesShare of the campaign's spend; recommended 30.
country_cut_rate_pctintegerYesA country's conversion rate as a percentage of its campaign's; recommended 50 (half).
country_cut_keepstring[]YesPinned countries (ISO 3166-1 alpha-2) — never cut.
country_cut_recommendedAdsCountryCutRecommendedYesCOUNTRYCUT — our recommended values, in the connection's currency.
business_typeAdsBusinessTypeYesBUILDL2 (za-153) — the kind of business the account sells for; it decides which conversion action is each signal-ladder stage's signal by default (by Google's conversion-action…
ladder_signalsAdsLadderSignalsYesBUILDL2 (za-153) — the customer's own choice of signal per stage: "1" (sign-up / lead), "2" (activation / qualified), "3" (paid) → conversion action resource names…
campaign_ladderAdsCampaignLadderYesBUILDL3 (gap a) — one account can sell two kinds of thing (hosting judged on a real domain going live, plugins on installs), so a campaign can carry its own business_type and/or…
pacing_modeAdsPacingModeYesza-N17 — when the month-end spend forecast drifts beyond pacing_deviation_pct from the target: auto corrects the daily budgets by itself (at most pacing_change_cap_pct,…
pacing_deviation_pctintegerYesza-N17: how far (percent) the month-end spend forecast may drift from the target before it is a warning (default 10).
pacing_target_minorobjectYesza-N17: the month's spend target in minor units of the account's currency; null = what the enabled daily budgets plan for the month, never above the monthly ceiling.
pacing_strategyAdsPacingStrategyYesza-199 (BUDGETMV1) — how the month's money is spread over its days: even (the same each day), day_of_week (the account's own weekday pattern over the last 28 days; the…
pacing_change_cap_pctintegerYesza-199 — the most one pacing run changes a budget, percent (default 30).
pacing_rolloverbooleanYesza-199 — carry last month's unspent spend target into this month (an explicit pacing_target_minor only, never chained, never past the monthly ceiling).
pacing_pause_overbooleanYesza-199 — once the month has spent its monthly ceiling, pause the campaigns that spend (through the pauses mode, with Undo) and resume them on the 1st. Off by default: under the…
pacing_minimumsobjectYesza-199 — Google campaign id → minimum daily budget in minor units; a pacing cut never takes the campaign under it.
tidy_paused_daysobjectYesADMGMT1 "Tidy paused ads after N days": an ad paused this many days (counted from the day Zinn® Ads first saw it paused) is deleted, keeping its snapshot and Rebuild. null = off,…
shield_min_clicksobjectYesIPROTATE (za-59): suspected clicks from one address before the click shield proposes excluding it. null = our recommended value (shield_recommended).
shield_stale_daysobjectYesAn exclusion whose source cost money within this many days is never rotated out at Google's 500-per-campaign cap. null = recommended.
shield_waste_min_clicksobjectYesClicks with cost and no conversion (30 days) before a placement or audience segment is proposed for exclusion. null = recommended.
shield_recommendedobjectYesOur recommended value of each shield threshold (shown as "Recommended").
tidy_paused_modestring<auto, suggest>Yessuggest (the default) queues each delete for approval; auto deletes it inside the ads mode (off still wins; a plan without autopilot queues it instead).
auto_bid_switchbooleanYesLADDERFIX (owner 2026-11-03): "Let Zinn® Ads switch bidding automatically when there's enough data". Default false: a move onto Maximise conversions, target CPA, Maximise…
auto_cap_raisebooleanYesAUTO3 (za-141, owner 2026-10-21: "Auto ON by default"): a converting campaign losing auctions on price gets its CPC cap raised by itself (+20%, once a week, at most twice the cap…
auto_push_testsbooleanYesza-110 (docs/1006 §69a, default on): the autopilot's push tests. A campaign on its own budget that loses at least 20% of its searches to budget (14 days, at least 30 clicks) gets…
push_test_max_runningintegerYesPush tests waiting or running at once on the account (default 2).
push_test_confidence_pctintegerYesPUSHTESTS (za-16, docs/1006 §82) — the confidence a budget test's result needs: a test is called worse only when its results per click moved with p below 1 - this/100. Recommended…
push_test_confidence_recommendedintegerYesPUSHTESTS (za-16) — the Recommended push_test_confidence_pct ("Reset to recommended").
budget_raise_modeAdsBudgetRaiseModeYesza-144 — a converting campaign held back by its budget (≥50% of impressions lost to budget at a cost per conversion at or below the account's, 7 days): auto raises it +25% by…
budget_raise_scopestring<all, campaigns>Yesza-144: all — budget_raise_mode for every campaign; campaigns — only the campaigns in budget_raise_campaigns, each with its own mode (the rest are flagged).
budget_raise_campaignsobjectYesGoogle campaign id → its budget-raise mode (used when the scope is campaigns).
budget_raise_builtbooleanYesza-111 (default on): a campaign Zinn® Ads built for this account (an applied, not undone, campaign create) is raised by itself while the autopilot is on; the account's own…
warm_start_untilobjectYesza-264: the end of a NEW Google connection's learning period (14 days from connect; null for an account connected before za-264, or one whose learning was ended). Until then an…
hold_until_salebooleanYes"Hold until a sale" (default on): the autopilot never raises a budget by itself while the account had no conversion in the last 30 days; the raise waits for approval.
roas_target_pctobjectYesThe 30-day return (conversion value per unit of spend, as a percentage: 400 = 4.0x) the autopilot needs before it raises a budget by itself; null = no target.
marketsAdsBuildMarket[]YesWhere new campaigns may run; empty = no limit. Launch skips the rest.
competitor_automationbooleanYesCompetitor campaigns are launched only while this is on AND the plan includes competitor groups (Pro and above).
collision_modestring<approve, refuse>Yesza-70: what happens to a negative keyword or keyword the collision simulator says would block this account's own keywords or the searches that bring results. approve (default):…
auto_new_countriesbooleanYesAUTO1 (za-105): when a country brings enough conversions cheaply inside campaigns that are not its own, propose it a campaign of its own (excluded from its parents in the same…
new_country_max_per_monthintegerYesAt most this many new-country campaigns proposed (or made) per calendar month.
new_country_budget_minorobjectYesStarting daily budget in minor units of the account currency; null = five whole units, raised to the country's measured spend before the split.
new_country_min_conversionsintegerYesThe trigger — conversions the country brought in 30 days.
new_country_min_clicksintegerYesThe trigger — clicks those conversions came from (30 days).
idstringYes—
org_idstringYes—
platformAdsPlatformYesAn advertising platform (docs/1006 §4.1).
external_idstringYes—
login_external_idstringYesThe manager account it is reached through.
labelstringYes—
statusstring<active, paused, disconnected>Yes—
modesAdsModesYesThe mode per action class. A class the account never set reads approve, except negatives, which reads auto: the audit blocks clear waste (searches that spent the money of a…
daily_ceiling_minorobjectYes—
monthly_ceiling_minorobjectYes—
ceiling_currencystringYes—
account_currencystringYesThe ad account's own ISO 4217 currency.
datamanager_grantedbooleanYesDMAPI2: this connection's conversions can be uploaded through the Data Manager API — the Google sign-in its token came from granted the auth/datamanager scope, or (za-238) it is…
uploads_need_reconnectbooleanYesDMAPI2: show "reconnect to enable conversion uploads" — a live Google connection whose grant lacks auth/datamanager while Connect asks for that scope. Signing in again and…
meta_scopesstring<ads_management, business_management, pages_show_list, pages_read_engagement>[]NoMETABUILD: the extended Meta permissions this connection's sign-in granted, each checked on its own (ads_read is always granted on a connection). Empty for every other network…
meta_needs_reconnectbooleanNoMETABUILD: show "Reconnect Meta Ads" — a live Meta connection lacking one of the extended permissions while Connect asks for them (ZINN_ADS_META_EXTENDED_SCOPES). Signing in…
vendor_grantsobjectNoTTFULL: what this connection's grant may do, MEASURED from the network's own answers (never typed). TikTok keys: writes (campaign, ad group, ad and negative keyword changes),…
grants_missingstring[]NoTTFULL: the vendor_grants keys the network refused for this grant. Non-empty: show "Reconnect" — signing in again and picking the same account replaces the token, and TikTok…
linkedin_writeobjectNoLIFULL: on a LinkedIn connection, whether its sign-in granted rw_ads (LinkedIn's own answer on the grant, never a typed flag), so an approved change can be sent; null on every…
needs_reconnectbooleanYesADSUI1 (za-243): the connection DROPPED — its latest finished read with its own token (the daily audit; for Meta the campaigns read) failed because the customer's credential was…
grant_refstringYesADSUI1 (za-246): the sign-in (OAuth grant) this connection's token came from. Accounts picked from one sign-in share it, so the dashboard groups accounts by network, then by…
pending_changesintegerYes—
pinterest_writeobjectNoPINFULL: on a Pinterest connection, whether its sign-in granted ads:write (read from Pinterest's own token answer, never typed) so approved changes can be sent, and whether the…
created_atstringYes—
disconnected_atobjectYes—

Errors this endpoint can return

401 · 403 · 404 · 422 · 429