API референца
ads
376 крајњих тачака у овој области. Свака има сопствену страницу са својим параметрима, одговором и захтевом који можете покренути.
| Метод | Путања | Шта ради | Дозвола |
|---|---|---|---|
| GET | /v1/ads/analytics/breakdown | Zinn® Ads analytics leaderboard by network, account, campaign, country, device or product/site (za-280, za-282). | ads.view |
| GET | /v1/ads/analytics/export | One analytics table as CSV or XLSX, every row (za-286). | ads.view |
| GET | /v1/ads/analytics/forecast | This month's spend so far, the month-end forecast with its band, and the spend ceiling it is held against (za-284). | ads.view |
| GET | /v1/ads/analytics/funnel | The funnel impression -> click -> conversion -> paid, and the customer's own measured outcomes beside the network's conversions (za-282). | ads.view |
| GET | /v1/ads/analytics/impact | How Zinn® Ads helped - money saved, fraud blocked, refunds won, conversions recovered, changes and before vs after (za-281). | ads.view |
| GET | /v1/ads/analytics/markers | What happened on each day of the chart - the changes made and the anomalies, each anomaly linked to the changes before it (za-284). | ads.view |
| GET | /v1/ads/analytics/markers/items | The changes behind a chart marker, newest first, paged, each with its Undo state (za-284). | Било који API кључ |
| POST | /v1/ads/analytics/narrative | The selected period in plain words - what moved, why, and where the month is heading - with every figure checked (za-285). | ads.view |
| GET | /v1/ads/analytics/summary | Zinn® Ads analytics KPI tiles for a period and its comparison (za-280). | ads.view |
| GET | /v1/ads/analytics/timeseries | Zinn® Ads analytics trend per day, week or month (za-280). | ads.view |
| GET | /v1/ads/analytics/views | The saved analytics views of the organisations the caller can see (za-286). | ads.view |
| POST | /v1/ads/analytics/views | Save the current analytics view under a name (za-286). | ads.view |
| GET | /v1/ads/analytics/views/recipients | The members of an organisation who can receive a saved view by e-mail (za-286). | ads.manage |
| DELETE | /v1/ads/analytics/views/{view_id} | Remove a saved view (za-286). | ads.view |
| PATCH | /v1/ads/analytics/views/{view_id} | Rename, re-save or schedule a saved view (za-286). | ads.view |
| POST | /v1/ads/analytics/views/{view_id}/send | E-mail a saved view to its recipients now (za-286). | ads.manage |
| GET | /v1/ads/asks | The organisation's recent "Ask your ads" questions and their checked answers (za-N7). | ads.view |
| POST | /v1/ads/asks | Ask a plain question about the organisation's own ads; the answer is checked figure by figure against cited facts (za-N7). | ads.view |
| POST | /v1/ads/asks/{ask_id}/fix | Keep the answer's one fix as a change waiting for approval (za-N7). | ads.manage |
| GET | /v1/ads/autopilot-decisions | The organisation's autopilot decisions — pinned and held campaigns, protected keywords. | ads.view |
| PATCH | /v1/ads/autopilot-decisions | Set the campaigns the autopilot must not touch and the keywords it must protect. | ads.manage |
| DELETE | /v1/ads/brief | Remove the brief (the budget stays, split by conversions per spend). | ads.manage |
| GET | /v1/ads/brief | The one brief across every ad network, and the split it drives. | ads.view |
| PUT | /v1/ads/brief | State the objective and the budget once, for every network. | ads.manage |
| POST | /v1/ads/brief/undo | Put back the brief the last save replaced. | ads.manage |
| GET | /v1/ads/briefs | The organisation's saved briefs, newest first (50). | ads.view |
| POST | /v1/ads/briefs | Save one brief for many networks and start reading the site. | ads.manage |
| GET | /v1/ads/briefs/networks | The ad networks a brief can launch on now. | ads.view |
| GET | /v1/ads/briefs/{brief_id} | One brief with each network's plan and the networks it could add now. | ads.view |
| POST | /v1/ads/briefs/{brief_id}/launch | Queue the named networks' plans as approve-first changes, together. | ads.manage |
| POST | /v1/ads/briefs/{brief_id}/plans | Make each named network's plan from the brief (now, or later to add a network). | ads.manage |
| GET | /v1/ads/briefs/{brief_id}/unlaunch | What Unlaunch would pause or cancel now (nothing is written). | ads.view |
| POST | /v1/ads/briefs/{brief_id}/unlaunch | Unlaunch a brief - pause everything it launched, approve-first, deleting nothing. | ads.manage |
| GET | /v1/ads/builds | The organisation's Simple-mode Google Ads plans, newest first (at most 20). | ads.view |
| POST | /v1/ads/builds | Start a Simple-mode plan from a website, a monthly budget and markets. | ads.manage |
| GET | /v1/ads/builds/{build_id} | One Simple-mode plan in full. | ads.view |
| PATCH | /v1/ads/builds/{build_id} | Change what they sell, the budget, the currency, the markets or the site languages before (re)building. | ads.manage |
| POST | /v1/ads/builds/{build_id}/build | Build (or rebuild) the plan from the current inputs. | ads.manage |
| POST | /v1/ads/builds/{build_id}/launch | Turn a ready plan into approve-first queued changes on one connected account. | ads.manage |
| POST | /v1/ads/campaign-offerings | Set (or clear, with no offering) which offering one campaign advertises. | ads.manage |
| POST | /v1/ads/campaign-offerings/lookup | Which offering each of many campaigns advertises, in one call. | ads.view |
| GET | /v1/ads/changes | The approve-first queue and the change history. | ads.view |
| POST | /v1/ads/changes/{change_id}/{action} | Approve, reject, undo, withdraw, or allow a rejected change again. | ads.manage |
| GET | /v1/ads/chat-channels | The organisation's Slack and Microsoft Teams alert channels (za-198). | ads.view |
| POST | /v1/ads/chat-channels | Connect a Slack incoming webhook or a Microsoft Teams Workflows webhook. | ads.manage |
| DELETE | /v1/ads/chat-channels/{channel_id} | Disconnect a chat channel and delete its webhook from Vault. | ads.manage |
| PATCH | /v1/ads/chat-channels/{channel_id} | Rename a chat channel, choose its alerts, switch it on or off, or replace its URL. | ads.manage |
| POST | /v1/ads/chat-channels/{channel_id}/test | Post a test message to the channel now. | ads.manage |
| GET | /v1/ads/client-approval-links | The client approval links the caller made (za-104). | ads.manage |
| POST | /v1/ads/client-approval-links | Make an approval link for a client org (za-104). | ads.manage |
| POST | /v1/ads/client-approval-links/{link_id}/revoke | Stop a client approval link working, now (za-104). | ads.manage |
| POST | /v1/ads/connect/amazon | Login with Amazon's authorize URL to connect Amazon Ads profiles (za-45). | ads.manage |
| GET | /v1/ads/connect/amazon/callback | Login with Amazon returns the browser here after the person authorises Zinn® Ads. | Нема API кључа |
| GET | /v1/ads/connect/amazon/grants/{grant_id} | The Amazon Ads profiles one Login with Amazon sign-in reaches. | ads.manage |
| POST | /v1/ads/connect/amazon/grants/{grant_id} | Connect the picked Amazon Ads profiles — one connection each — and read them. | ads.manage |
| POST | /v1/ads/connect/chatgpt | Connect ChatGPT Ads with an Advertiser API key (za-318). | ads.manage |
| GET | /v1/ads/connect/chatgpt/grants/{grant_id} | The ChatGPT Ads account one Advertiser API key reaches. | ads.manage |
| POST | /v1/ads/connect/chatgpt/grants/{grant_id} | Connect the key's ChatGPT Ads account and start reading its figures. | ads.manage |
| POST | /v1/ads/connect/google | Google's consent URL to connect Google Ads accounts. | ads.manage |
| GET | /v1/ads/connect/google/callback | Google returns the browser here after consent. | Нема API кључа |
| GET | /v1/ads/connect/google/grants/{grant_id} | The Google Ads accounts one sign-in reaches. | ads.manage |
| POST | /v1/ads/connect/google/grants/{grant_id} | Connect the picked Google Ads accounts — one connection each. | ads.manage |
| POST | /v1/ads/connect/linkedin | LinkedIn's authorize URL to connect LinkedIn ad accounts (za-41). | ads.manage |
| GET | /v1/ads/connect/linkedin/callback | LinkedIn returns the browser here after the member authorises Zinn® Ads. | Нема API кључа |
| GET | /v1/ads/connect/linkedin/grants/{grant_id} | The LinkedIn ad accounts one LinkedIn sign-in reaches. | ads.manage |
| POST | /v1/ads/connect/linkedin/grants/{grant_id} | Connect the picked LinkedIn ad accounts — one connection each — and read them. | ads.manage |
| POST | /v1/ads/connect/meta | Meta's authorize URL to connect Meta (Facebook and Instagram) ad accounts (za-40). | ads.manage |
| GET | /v1/ads/connect/meta/callback | Meta returns the browser here after the person authorises Zinn® Ads. | Нема API кључа |
| GET | /v1/ads/connect/meta/grants/{grant_id} | The Meta ad accounts one Facebook sign-in reaches. | ads.manage |
| POST | /v1/ads/connect/meta/grants/{grant_id} | Connect the picked Meta ad accounts — one connection each — and read them. | ads.manage |
| POST | /v1/ads/connect/microsoft | Microsoft's consent URL to connect Microsoft Advertising accounts (za-39). | ads.manage |
| GET | /v1/ads/connect/microsoft/callback | Microsoft returns the browser here after consent. | Нема API кључа |
| GET | /v1/ads/connect/microsoft/grants/{grant_id} | The Microsoft Advertising accounts one sign-in reaches. | ads.manage |
| POST | /v1/ads/connect/microsoft/grants/{grant_id} | Connect the picked Microsoft Advertising accounts — one connection each. | ads.manage |
| POST | /v1/ads/connect/pinterest | Pinterest's authorize URL to connect Pinterest ad accounts (za-44). | ads.manage |
| GET | /v1/ads/connect/pinterest/callback | Pinterest returns the browser here after the person authorises Zinn® Ads. | Нема API кључа |
| GET | /v1/ads/connect/pinterest/grants/{grant_id} | The Pinterest ad accounts one Pinterest sign-in reaches. | ads.manage |
| POST | /v1/ads/connect/pinterest/grants/{grant_id} | Connect the picked Pinterest ad accounts — one connection each — and read them. | ads.manage |
| POST | /v1/ads/connect/tiktok | TikTok's authorize URL to connect TikTok advertisers (za-42). | ads.manage |
| GET | /v1/ads/connect/tiktok/callback | TikTok returns the browser here after the person authorises Zinn® Ads. | Нема API кључа |
| GET | /v1/ads/connect/tiktok/grants/{grant_id} | The TikTok advertisers one TikTok sign-in reaches. | ads.manage |
| POST | /v1/ads/connect/tiktok/grants/{grant_id} | Connect the picked TikTok advertisers — one connection each — and read them. | ads.manage |
| POST | /v1/ads/connect/x | X's authorize URL to connect X ad accounts (XADS1). | ads.manage |
| GET | /v1/ads/connect/x/callback | X returns the browser here after the person authorises Zinn® Ads. | Нема API кључа |
| GET | /v1/ads/connect/x/grants/{grant_id} | The X ad accounts one X sign-in reaches — live and sandbox. | ads.manage |
| POST | /v1/ads/connect/x/grants/{grant_id} | Connect the picked X ad accounts — one connection each. | ads.manage |
| GET | /v1/ads/connections | The organisation's connected ad accounts. | ads.view |
| PATCH | /v1/ads/connections/{connection_id} | The account's autopilot settings — modes, ceilings, hold, ROAS, markets, competitors. | ads.manage |
| GET | /v1/ads/connections/{connection_id}/account-checks | The house checks on this account, in figures (za-82, za-83, za-88, za-89). | ads.view |
| GET | /v1/ads/connections/{connection_id}/acquisition-quality | Customer quality per keyword, ad group and country — bad-customer rate against the rest of the account (za-215). | ads.view |
| GET | /v1/ads/connections/{connection_id}/ad-quality | Ad quality — Limited Ad Serving, weak ads and their rewrites (za-150, za-162..165). | ads.view |
| GET | /v1/ads/connections/{connection_id}/ads | The account's campaigns, ad groups and ads, read from Google now (ADMGMT1). | ads.view |
| POST | /v1/ads/connections/{connection_id}/ads/actions | Pause, unpause or delete one ad, ad group or campaign (ADMGMT1). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/ai-max | The AI Max for Search guard — expanded searches against keyword-matched ones, their return, and the customer's own rules (za-204). | ads.view |
| PATCH | /v1/ads/connections/{connection_id}/ai-max | Set the customer's own AI Max guard rules; a rule sent as null is Reset to recommended (za-204). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/allowed-terms | Competitor names allowed in one ad group each (za-237). | ads.view |
| POST | /v1/ads/connections/{connection_id}/allowed-terms | Allow a competitor's name in ONE ad group's ad text (audited). | ads.manage |
| DELETE | /v1/ads/connections/{connection_id}/allowed-terms/{allowance_id} | Withdraw an allowance; the name is refused in that group again (audited). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/amazon/campaigns | An Amazon Ads profile's Sponsored Products campaigns with their daily budgets (AMZBIDS). | ads.view |
| GET | /v1/ads/connections/{connection_id}/amazon/campaigns/{campaign_id}/ad-groups | One Amazon Ads campaign's ad groups with their default bids and keyword bids (AMZBIDS). | ads.view |
| POST | /v1/ads/connections/{connection_id}/amazon/campaigns/{campaign_id}/ad-groups/{ad_group_id}/bid | Change an Amazon Ads ad group's default bid — the click is the approval (AMZBIDS). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/amazon/campaigns/{campaign_id}/budget | Change an Amazon Ads campaign's daily budget — the click is the approval (AMZBIDS). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/amazon/campaigns/{campaign_id}/keywords/{keyword_id}/bid | Change an Amazon Ads keyword's bid — the click is the approval (AMZBIDS). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/audiences | The customer's own Customer Match lists for this Google Ads account. | ads.view |
| POST | /v1/ads/connections/{connection_id}/audiences | Create a Customer Match list, recording the consent its people gave. | ads.manage |
| DELETE | /v1/ads/connections/{connection_id}/audiences/{audience_id} | Empty a Customer Match list — everyone on it is removed at the network. | ads.manage |
| PATCH | /v1/ads/connections/{connection_id}/audiences/{audience_id} | Rename a Customer Match list or change its recorded consent and terms. | ads.manage |
| DELETE | /v1/ads/connections/{connection_id}/audiences/{audience_id}/crm-feed | Stop filling a list from the CRM; everyone it added is removed. | ads.manage |
| PUT | /v1/ads/connections/{connection_id}/audiences/{audience_id}/crm-feed | Fill a Customer Match list automatically from one of your CRM sources. | ads.manage |
| POST | /v1/ads/connections/{connection_id}/audiences/{audience_id}/members | Add, remove or replace the people on a Customer Match list (hashed on arrival). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/audiences/{audience_id}/sync | Send a Customer Match list's difference to the network now. | ads.manage |
| GET | /v1/ads/connections/{connection_id}/audits | The connection's recent audit runs (newest first, at most 20). | ads.view |
| POST | /v1/ads/connections/{connection_id}/audits | Run the connection's audit now (a Temporal workflow). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/auto-apply | Switch one of Google's auto-apply types off, or back on (za-194). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/autopilot | What the autopilot does on this account. | ads.view |
| GET | /v1/ads/connections/{connection_id}/bid-ladder | Every campaign's bid-strategy step, verdict, figures and learning freeze (za-183). | ads.view |
| POST | /v1/ads/connections/{connection_id}/bid-ladder/{campaign_id}/dismiss | Say no to the step a ladder row proposes (za-183). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/bid-ladder/{campaign_id}/switch | The one click that moves a campaign the step its ladder row proposes (za-183). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/brand-watch | Competitor watch — who started bidding on this account's brand terms (za-N9). | ads.view |
| PATCH | /v1/ads/connections/{connection_id}/brand-watch | Edit the competitor watch — switch, thresholds, extra brand terms (za-N9). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/brand-watch/seen | Mark every new competitor alert on this account as seen (za-N9). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/budget-decisions | The customer's own budget decisions on this Google Ads account (za-84). | ads.view |
| POST | /v1/ads/connections/{connection_id}/budget-decisions | Record the customer's own budget for one campaign (za-84). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/budget-decisions/{key}/settle | Answer or end one of the customer's budget decisions (za-84). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/budget-flags | Campaigns held back by their budget while they convert (za-142). | ads.view |
| POST | /v1/ads/connections/{connection_id}/budget-flags/{flag_id}/raise | The one-click raise of a budget-limited campaign (za-142). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/call-numbers | The ad account's Zinn® tracking numbers and their prices (za-160). | ads.view |
| POST | /v1/ads/connections/{connection_id}/call-numbers | Buy one tracking number that forwards to the customer's own number (za-160). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/call-numbers/available | Local numbers the customer could buy, each at its measured price (za-160). | ads.view |
| DELETE | /v1/ads/connections/{connection_id}/call-numbers/{number_id} | Release a tracking number — it stops costing anything (za-160). | ads.manage |
| PATCH | /v1/ads/connections/{connection_id}/call-numbers/{number_id} | Change where a tracking number forwards, or its name (za-160). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/checkout-sources | The checkout providers sending this ad account their sales by webhook. | ads.view |
| POST | /v1/ads/connections/{connection_id}/checkout-sources | Add a checkout provider (Stripe, Paddle or Freemius) with its webhook signing secret. | ads.manage |
| DELETE | /v1/ads/connections/{connection_id}/checkout-sources/{source_id} | Remove a checkout source and forget its signing secret. | ads.manage |
| PATCH | /v1/ads/connections/{connection_id}/checkout-sources/{source_id} | Replace the signing secret, rename, or switch a checkout source on or off. | ads.manage |
| GET | /v1/ads/connections/{connection_id}/competitor-groups | Competitor ad groups in every language - thresholds and the last run (za-15, za-71). | ads.view |
| PATCH | /v1/ads/connections/{connection_id}/competitor-groups | Edit a competitor ad group threshold; null puts it back on Recommended (audited). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/conversion-setup | Conversion setup — GA4 key-event import or the server-side upload, each measured (za-12). | ads.view |
| PUT | /v1/ads/connections/{connection_id}/conversion-setup | Choose the conversion method, the GA4 property and key events, and the working window. | ads.manage |
| POST | /v1/ads/connections/{connection_id}/conversion-setup/queue | Queue one approve-first change — import the chosen GA4 key events, or create the upload action. | ads.manage |
| GET | /v1/ads/connections/{connection_id}/copy-winners | Copy winners across your own accounts and countries - settings and the last run (za-N5). | ads.view |
| PATCH | /v1/ads/connections/{connection_id}/copy-winners | Edit copy winners - switch, mode, thresholds; null puts a threshold back on Recommended (audited). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/country-campaigns | A customer's country campaigns, and the converting countries without one (za-75). | ads.view |
| GET | /v1/ads/connections/{connection_id}/crm-sources | The account's CRM, sheet and call-log sources and their stage mapping (za-160). | ads.view |
| DELETE | /v1/ads/connections/{connection_id}/crm-sources/{vendor} | Remove one CRM / sheet / call-log source (za-160). | ads.manage |
| PUT | /v1/ads/connections/{connection_id}/crm-sources/{vendor} | Connect or update one CRM / sheet / call-log source and its stage mapping (za-160). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/crm-sources/{vendor}/stages | The stages the connected CRM holds, to map to conversion actions (za-160). | ads.view |
| POST | /v1/ads/connections/{connection_id}/crm-sources/{vendor}/sync | Read the CRM's changes now, instead of waiting for the daily audit (za-160). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/crm-sources/{vendor}/upload | Send one CSV file of leads or of calls (za-160). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/diagnosis | Every campaign's "not showing — why" and budget pacing (za-76). | ads.view |
| POST | /v1/ads/connections/{connection_id}/disconnect | Disconnect an ad account; its token and all its data are deleted. | ads.manage |
| GET | /v1/ads/connections/{connection_id}/experiments | The account's dated budget tests (za-193). | ads.view |
| POST | /v1/ads/connections/{connection_id}/experiments | Start a dated budget test — kept as ONE change waiting for approval (za-193). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/findings | What the daily audit found on the account, with its figures (FINDALL1, za-211). | ads.view |
| POST | /v1/ads/connections/{connection_id}/findings/{finding_id}/{action} | The one click on a finding — apply it, or dismiss it (FINDALL1, za-211). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/geo-holdouts | The account's geo hold-outs — incrementality tests by country (za-202). | ads.view |
| GET | /v1/ads/connections/{connection_id}/geo-holdouts/settings | The customer's geo hold-out thresholds, with the Recommended values (za-202). | ads.view |
| PUT | /v1/ads/connections/{connection_id}/geo-holdouts/settings | Store the customer's geo hold-out thresholds (za-202). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/geo-holdouts/{holdout_id}/approve | Approve a proposed geo hold-out (za-202). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/geo-holdouts/{holdout_id}/decline | Decline a proposed geo hold-out (za-202). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/geo-holdouts/{holdout_id}/stop | End a running geo hold-out now (za-202). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/google-changes | Changes Google made in this account by itself, judged against the customer's rules (za-194). | ads.view |
| POST | /v1/ads/connections/{connection_id}/google-changes/{change_id}/undo | Put back a change Google made by itself (za-194). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/grow | The account's operating plan — this week's "Suggestions to grow" and the calendar (za-85). | ads.view |
| POST | /v1/ads/connections/{connection_id}/grow/{suggestion_id}/decide | Mark a suggestion done or dismissed, or open again (za-85). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/history-imports | The Recommended history-import thresholds and this ad account's history imports. | ads.view |
| POST | /v1/ads/connections/{connection_id}/history-imports | Import an older ad account's history and the revenue to seed the autopilot's starting values. | ads.manage |
| GET | /v1/ads/connections/{connection_id}/imported | The connected Google Ads account's whole structure as last read (za-262). | ads.view |
| POST | /v1/ads/connections/{connection_id}/imported/refresh | Read the connected Google Ads account's structure again now (za-262). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/insights | Spend pacing, tracking still firing, missed clicks and the signal ladder. | ads.view |
| GET | /v1/ads/connections/{connection_id}/landing-pages | Every ad final URL's last landing-page check (LPDIAG2, za-205/za-209). | ads.view |
| GET | /v1/ads/connections/{connection_id}/linkedin/campaigns | A LinkedIn ad account's campaigns with status, daily budget, bid and 7-day spend (LIFULL). | ads.view |
| POST | /v1/ads/connections/{connection_id}/linkedin/changes | Pause, resume, re-budget or re-bid one LinkedIn campaign — the click is the approval (LIFULL). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/matching-pages | Matching landing pages — the connection's pages and candidate ad groups (za-N6). | ads.view |
| POST | /v1/ads/connections/{connection_id}/matching-pages/scan | Find the ad groups whose ads land on a site hosted with us (za-N6). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/matching-pages/{page_id} | One matching landing page (za-N6). | ads.view |
| POST | /v1/ads/connections/{connection_id}/matching-pages/{page_id}/approve | Approve and publish the page, then switch the ad group's final URL (za-N6). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/matching-pages/{page_id}/discard | Throw away a written page that was never published (za-N6). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/matching-pages/{page_id}/preview | The server-rendered page, exactly as it will be published (za-N6). | ads.view |
| POST | /v1/ads/connections/{connection_id}/matching-pages/{page_id}/unpublish | Undo — put the old final URL back, then remove the page (za-N6). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/matching-pages/{page_id}/write | Write (or rewrite) the page with the AI writer (za-N6). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/measurement-health | Optimisation score, conversion goals, offline uploads and PMax automation (za-253). | ads.view |
| GET | /v1/ads/connections/{connection_id}/merchant-feed | The account's Shopping + Merchant Center feed audit (za-188). | ads.view |
| PATCH | /v1/ads/connections/{connection_id}/merchant-feed | Change the feed audit's settings (za-188). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/meta/adsets | A Meta ad account's ad sets with their status, daily budget and 7-day spend (METABUILD). | ads.view |
| POST | /v1/ads/connections/{connection_id}/meta/adsets/{adset_id}/budget | Change a Meta ad set's daily budget — the click is the approval (METABUILD). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/meta/adsets/{adset_id}/status | Pause or resume a Meta ad set — the click is the approval (METABUILD). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/meta/campaigns | A Meta account's campaigns and spend over the last 30 days (za-40). | ads.view |
| POST | /v1/ads/connections/{connection_id}/meta/campaigns/refresh | Read a Meta account's campaigns and spend again now. | ads.manage |
| GET | /v1/ads/connections/{connection_id}/meta/pages | The Facebook Pages a Meta connection runs ads from, with name, picture and followers (METABUILD). | ads.view |
| GET | /v1/ads/connections/{connection_id}/microsoft/import-google | What importing the org's Google Ads Search campaigns into this Microsoft account would queue (za-39). | ads.view |
| POST | /v1/ads/connections/{connection_id}/microsoft/import-google | Queue the ready Google Ads Search campaigns as pending Microsoft changes (za-39). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/network-campaigns | Any campaign-feed network account's campaigns and spend over the last 30 days (za-54). | ads.view |
| POST | /v1/ads/connections/{connection_id}/network-campaigns/refresh | Read a campaign-feed network account's campaigns and spend again now (za-54). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/next-country | The countries this account could open next, ranked, and the one approve-only proposal (za-N10). | ads.view |
| PATCH | /v1/ads/connections/{connection_id}/next-country | The next-country advisor's mode, "buying countries only" and the customer's own thresholds (za-N10). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/objectives | Every campaign's objective, the proposal waiting and the judgement against it (za-184). | ads.view |
| PUT | /v1/ads/connections/{connection_id}/objectives/{campaign_id} | Propose a campaign's objective — approve-first, it changes nothing yet (za-184). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/objectives/{campaign_id}/approve | A person's approval puts the proposed objective in force (za-184). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/objectives/{campaign_id}/reject | Drop a proposed objective; nothing changes (za-184). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/organic | Each paid keyword beside the same query's organic clicks and position (za-191). | ads.view |
| PATCH | /v1/ads/connections/{connection_id}/organic | Pick the Search Console property and edit the paid-vs-organic saver (za-191, za-N3). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/organic/sites | The Search Console properties this account's Google sign-in can read (za-191). | ads.view |
| GET | /v1/ads/connections/{connection_id}/outcomes | The real outcomes received for this account (newest first, at most 200). | ads.view |
| POST | /v1/ads/connections/{connection_id}/outcomes | The events API — send real outcomes (sales, trials, leads, sign-ups). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/outcomes/retractions | Withdraw outcomes you sent, by your own id (a full refund). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/page-fixes | Landing-page fixes applied on sites hosted with us (za-210). | ads.view |
| POST | /v1/ads/connections/{connection_id}/page-fixes | Write the fix for one landing-page finding on a page hosted with us (za-210). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/page-fixes/{fix_id} | One landing-page fix (za-210). | ads.view |
| POST | /v1/ads/connections/{connection_id}/page-fixes/{fix_id}/approve | Apply the fix to the page on the site (za-210). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/page-fixes/{fix_id}/discard | Drop a fix never applied (za-210). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/page-fixes/{fix_id}/preview | The page as it is and as it will be after the fix (za-210). | ads.view |
| POST | /v1/ads/connections/{connection_id}/page-fixes/{fix_id}/undo | Put the snapshot back (za-210, one click, 30 days). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/paid-geo | Paid revenue by country and by campaign device, and what it proposes (za-168). | ads.view |
| PATCH | /v1/ads/connections/{connection_id}/paid-geo | The mode and the customer's own thresholds for paid revenue by country and device (za-168). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/paused-ads/delete | Delete all paused ads of one account (ADMGMT1). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/placement-goals | Every top-of-page goal, measured, diagnosed and priced (za-187). | ads.view |
| DELETE | /v1/ads/connections/{connection_id}/placement-goals/{campaign_id} | Remove a campaign's top-of-page goal (za-187). | ads.manage |
| PUT | /v1/ads/connections/{connection_id}/placement-goals/{campaign_id} | Set a campaign's top-of-page goal — it sends nothing to the ad account (za-187). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/plugin-feed | The plugin conversion actions on your own ad account and what each recorded (za-96). | ads.view |
| PUT | /v1/ads/connections/{connection_id}/plugin-feed | Switch the plugin conversion feed on or off for this ad account. | ads.manage |
| GET | /v1/ads/connections/{connection_id}/pmax | The account's Performance Max reading (za-185). | ads.view |
| DELETE | /v1/ads/connections/{connection_id}/product-analytics | Disconnect the product analytics project (za-190). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/product-analytics | The customer's product analytics source and the lead quality it measures (za-190). | ads.view |
| PUT | /v1/ads/connections/{connection_id}/product-analytics | Connect or update the product analytics project (za-190). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/product-analytics/sync | Read the product analytics now, instead of waiting for the daily audit (za-190). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/product-trials | Each product's free-trial length, our recommendation, and the longest trial. | ads.view |
| PUT | /v1/ads/connections/{connection_id}/product-trials | Set the free-trial length of named products (null resets to recommended). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/profit | Profit bidding (POAS) — value basis, product costs, fee estimates and the margin sent. | ads.view |
| PUT | /v1/ads/connections/{connection_id}/profit | Turn profit bidding on or off, set product costs and fee estimates. | ads.manage |
| GET | /v1/ads/connections/{connection_id}/prospecting | The Prospecting template's choices - business types, starter negatives, budget (za-158). | ads.view |
| POST | /v1/ads/connections/{connection_id}/prospecting | Start building a Prospecting campaign preview from intent groups (za-158). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/prospecting/{preview_id} | One Prospecting preview - building, ready with the plan, failed or expired (za-158). | ads.view |
| POST | /v1/ads/connections/{connection_id}/prospecting/{preview_id}/propose | Queue a ready Prospecting preview as ONE approve-first change (za-158). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/quality-score | The Quality Score fixer — weak keywords, their weakest part and its fix (QSFIX, za-N11). | ads.view |
| PATCH | /v1/ads/connections/{connection_id}/quality-score | The account's own Quality Score fixer values (QSFIX, za-N11). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/quality-segments | Sign-ups, activations and sales per keyword, search term, country and device (za-156). | ads.view |
| PATCH | /v1/ads/connections/{connection_id}/quality-segments | The mode and the customer's own thresholds for quality by segment (za-156). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/relist | Add accounts from the sign-in this account was connected with. | ads.manage |
| GET | /v1/ads/connections/{connection_id}/reviews | The account's scheduled reviews, and what a new one can cover (AUTOREVIEW1). | ads.view |
| POST | /v1/ads/connections/{connection_id}/reviews | Schedule a review; its own Temporal workflow judges it on the due day (AUTOREVIEW1). | ads.manage |
| DELETE | /v1/ads/connections/{connection_id}/reviews/{review_id} | Cancel a scheduled or due review (AUTOREVIEW1). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/reviews/{review_id}/decide | The one-click decision on a due review (AUTOREVIEW1). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/reviews/{review_id}/undo | Put a review's decision back and open the review again (AUTOREVIEW1). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/rsa-tests | RSA A/B tests — variants rotated, winners called at the customer's confidence (za-197). | ads.view |
| GET | /v1/ads/connections/{connection_id}/rules | The account's own rules — "if a figure over a window then an action" (za-196). | ads.view |
| POST | /v1/ads/connections/{connection_id}/rules | Create a rule; it runs on its own daily Temporal schedule (za-196). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/rules/preview | What a rule WOULD have done on the account's last N days of real figures (za-196). | ads.view |
| DELETE | /v1/ads/connections/{connection_id}/rules/{rule_id} | Delete a rule and its schedule (za-196). | ads.manage |
| PATCH | /v1/ads/connections/{connection_id}/rules/{rule_id} | Change a rule, or switch it on or off (za-196). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/rules/{rule_id}/runs | A rule's run log — every run, what it read and what it did (za-196). | ads.view |
| POST | /v1/ads/connections/{connection_id}/rules/{rule_id}/runs/{run_id}/undo | Undo every change one run made, within 30 days (za-196). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/scorecard | Did each automatic change do what it said? The 14-day scorecard (za-214). | ads.view |
| GET | /v1/ads/connections/{connection_id}/seasonal | The seasonal planner per country — demand by month, thresholds and dated proposals. | ads.view |
| PUT | /v1/ads/connections/{connection_id}/seasonal | Edit the seasonal planner's thresholds or mode, or reset them to Recommended. | ads.manage |
| POST | /v1/ads/connections/{connection_id}/seasonal/plans/{plan_id}/dismiss | Dismiss one seasonal proposal; its pending changes are rejected. | ads.manage |
| GET | /v1/ads/connections/{connection_id}/signal-values | What one sign-up and one activation are worth, measured, and what the network counts. | ads.view |
| PATCH | /v1/ads/connections/{connection_id}/signal-values | Send or only measure a signal's value, set your own value, or choose its action. | ads.manage |
| PATCH | /v1/ads/connections/{connection_id}/site-guard-settings | Hosting-aware ads — the switch and thresholds (za-207). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/site-guards | The account's site guards — pause the ads while the site is down (za-N1). | ads.view |
| POST | /v1/ads/connections/{connection_id}/site-guards | Guard one of the org's uptime monitors for this ad account (za-N1). | ads.manage |
| DELETE | /v1/ads/connections/{connection_id}/site-guards/{guard_id} | Remove a site guard (za-N1). | ads.manage |
| PATCH | /v1/ads/connections/{connection_id}/site-guards/{guard_id} | Switch a site guard on or off, or change its campaigns (za-N1). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/site-guards/{guard_id}/sync | Check now — reconcile a site guard to its monitor (za-N1). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/stock-pause | Out-of-stock pause — the settings and the connected WooCommerce shops (za-N2). | ads.view |
| PATCH | /v1/ads/connections/{connection_id}/stock-pause | Change the out-of-stock pause settings, or reset them to Recommended (za-N2). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/stock-pause/products/{product_id}/sync | Check now — reconcile one product's ads to its stock (za-N2). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/stock-pause/stores | Connect a WooCommerce shop for the out-of-stock pause (za-N2). | ads.manage |
| DELETE | /v1/ads/connections/{connection_id}/stock-pause/stores/{store_id} | Disconnect a shop (za-N2). | ads.manage |
| PATCH | /v1/ads/connections/{connection_id}/stock-pause/stores/{store_id} | Switch a connected shop on or off, or rename it (za-N2). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/stock-pause/stores/{store_id}/secret | Show a shop's webhook secret again (za-N2). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/stock-pause/stores/{store_id}/secret/rotate | Rotate a shop's webhook secret (OWNERFIX-C). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/tiktok/changes | Pause, resume, re-budget, re-bid, exclude audiences or add a negative keyword on TikTok — the click is the approval (TTFULL). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/tiktok/objects | A TikTok advertiser's campaigns, ad groups and ads with status, budget, bid and 7-day spend (TTFULL). | ads.view |
| GET | /v1/ads/connections/{connection_id}/tracking | The account's tracking truth check, confidence gate, fix assistant and recovery. | ads.view |
| PUT | /v1/ads/connections/{connection_id}/tracking | Which actions are compared, where missed outcomes upload, recovery on/off. | ads.manage |
| GET | /v1/ads/connections/{connection_id}/tracking/actions | The account's offline-upload conversion actions, read live from the network. | ads.view |
| POST | /v1/ads/connections/{connection_id}/tracking/check | Run the tracking check and the recovery upload now (a Temporal workflow). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/tracking/retry | Send the uploads Google never gave a verdict on again (a person's retry). | ads.manage |
| GET | /v1/ads/connections/{connection_id}/universal-negatives | The ad account's one list of universal negative keywords and its sync state. | ads.view |
| GET | /v1/ads/connections/{connection_id}/video | The account's Video and Demand Gen reading and its YouTube channel (za-201). | ads.view |
| PUT | /v1/ads/connections/{connection_id}/video | Save (or clear) the customer's own YouTube channel on a Google connection (za-201). | ads.manage |
| POST | /v1/ads/connections/{connection_id}/warm-start/end | End a new ad account's learning period early. | ads.manage |
| GET | /v1/ads/connections/{connection_id}/x/campaigns | An X Ads account's campaigns with their daily and total budgets and 7-day spend (za-43). | ads.view |
| POST | /v1/ads/connections/{connection_id}/x/campaigns/{campaign_id}/budget | Change an X campaign's daily budget — the click is the approval (za-43). | ads.manage |
| GET | /v1/ads/controls | The organisation's kill switch and daily e-mail setting. | ads.view |
| PUT | /v1/ads/controls | Turn the organisation's kill switch or daily e-mail on or off. | ads.manage |
| GET | /v1/ads/cross-budget | The organisation's one monthly ceiling across every ad network, and today's proposal. | ads.view |
| PUT | /v1/ads/cross-budget | Set or clear the one monthly ceiling across every network, and the mode. | ads.manage |
| POST | /v1/ads/cross-budget/apply | Apply today's proposal to each network's monthly ceiling. | ads.manage |
| POST | /v1/ads/cross-budget/undo | Put back the monthly ceilings from before the last apply. | ads.manage |
| POST | /v1/ads/email-actions | Act on an e-mailed Approve, Undo or Apply link (signed in). | ads.manage |
| GET | /v1/ads/events | The server events you sent, newest first, with what each connected network did. | ads.view |
| POST | /v1/ads/events | The server events API — send a conversion once; it goes to every connected network. | ads.manage |
| GET | /v1/ads/history-imports/{import_id} | One history import — its progress, its evidence and the starting values it seeded. | ads.view |
| 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). | ads.manage |
| GET | /v1/ads/network-notices | The ad-network changes that affect this organisation's accounts (za-195). | ads.view |
| POST | /v1/ads/network-notices/{match_id}/acknowledge | Mark a network notice as seen; it never shows, mails or re-proposes again. | ads.manage |
| GET | /v1/ads/networks | Every ad network Zinn® Ads has a driver for (za-54). | ads.view |
| GET | /v1/ads/offerings | Search the things the organisation advertises (sites, products, services, apps, locations, events, lead forms, offers). | ads.view |
| POST | /v1/ads/offerings | Add one thing the organisation advertises. | ads.manage |
| POST | /v1/ads/offerings/match | Assign a Google Ads account's campaigns to offerings by their ads' final URLs. | ads.manage |
| GET | /v1/ads/offerings/{offering_id} | One offering. | ads.view |
| PATCH | /v1/ads/offerings/{offering_id} | Change an offering, or archive or restore it. | ads.manage |
| GET | /v1/ads/own-share | What this company learned across its own ad accounts, and the sharing setting. | ads.view |
| PATCH | /v1/ads/own-share | Turn sharing across this company's own accounts on or off, and choose the mode. | ads.manage |
| GET | /v1/ads/plan | The organisation's Zinn® Ads plan, what it uses and what it allows. | ads.view |
| GET | /v1/ads/report | Reporting per ad account and per agency client (za-23). | ads.view |
| GET | /v1/ads/report/pdf | One client's white-label advertising report as a PDF (za-200). | ads.view |
| GET | /v1/ads/report/rows | Daily campaign rows for Looker Studio (za-200). | ads.view |
| GET | /v1/ads/report/schedules | The scheduled white-label PDF reports (za-200). | ads.view |
| POST | /v1/ads/report/schedules | Create or replace a client's weekly or monthly PDF report (za-200). | ads.manage |
| DELETE | /v1/ads/report/schedules/{schedule_id} | Stop and remove a scheduled report (za-200). | ads.manage |
| PATCH | /v1/ads/report/schedules/{schedule_id} | Change a scheduled report's recipients, language, window or on/off (za-200). | ads.manage |
| POST | /v1/ads/report/schedules/{schedule_id}/send | E-mail this period's report now, without moving the schedule (za-200). | ads.manage |
| GET | /v1/ads/shield | The organisation's click-fraud shield and its totals for a period. | ads.view |
| PUT | /v1/ads/shield | Switch the shield off or on, and set the figures its estimate uses. | ads.manage |
| GET | /v1/ads/shield/claims | Refund evidence packs, one per Google Ads account per month. | ads.view |
| GET | /v1/ads/shield/claims/{claim_id} | One refund evidence pack with every suspected click. | ads.view |
| POST | /v1/ads/shield/claims/{claim_id}/outcome | Record Google's answer to a sent pack (credit received or none). | ads.manage |
| POST | /v1/ads/shield/claims/{claim_id}/sent | Record that a person sent the pack through Google's form. | ads.manage |
| GET | /v1/ads/shield/clicks | Scored paid clicks on the organisation's hosted sites, newest first. | ads.view |
| GET | /v1/ads/shield/exclusions | The IP, placement and audience exclusions the shield asked Google for. | ads.view |
| POST | /v1/ads/shield/exclusions/{exclusion_id}/undo | Undo one click-shield exclusion (one click). | ads.manage |
| GET | /v1/ads/shield/meta-block-list | A Meta connection's Zinn-held publisher block list (PLACEGUARD2, za-N18). | ads.view |
| GET | /v1/ads/site-tags | Install on any site — the organisation's site tags with their install code. | ads.view |
| POST | /v1/ads/site-tags | Add a site and mint its public tag key. | ads.manage |
| DELETE | /v1/ads/site-tags/{tag_id} | Remove a site tag; its script answers 404 from then on. | ads.manage |
| GET | /v1/ads/site-tags/{tag_id} | One site tag with its install code. | ads.view |
| PUT | /v1/ads/site-tags/{tag_id} | Change a site tag (every install route follows within five minutes). | ads.manage |
| DELETE | /v1/ads/site-tags/{tag_id}/first-party | Remove the first-party route, Worker and stored token. | ads.manage |
| GET | /v1/ads/site-tags/{tag_id}/first-party | First-party tracking for this site on the customer's own Cloudflare (za-123). | ads.view |
| PUT | /v1/ads/site-tags/{tag_id}/first-party | Deploy first-party tracking with the customer's own Cloudflare API token. | ads.manage |
| POST | /v1/ads/site-tags/{tag_id}/first-party/check | Ask Cloudflare whether the first-party route still serves this site. | ads.manage |
| GET | /v1/ads/site-tags/{tag_id}/gtm-container | The Google Tag Manager container to import, built from the same site tag. | ads.view |
| GET | /v1/ads/social | The social-network autopilot on this org's X, Meta and TikTok accounts. | ads.view |
| GET | /v1/ads/tracking-hub | The tracking hub — every network tag, conversion id and server-side key status. | ads.view |
| PUT | /v1/ads/tracking-hub | Change the hub's tag ids and conversion ids. | ads.manage |
| DELETE | /v1/ads/tracking-hub/keys/{kind} | Remove one server-side key from Vault and from the hub. | ads.manage |
| PUT | /v1/ads/tracking-hub/keys/{kind} | Store one server-side key (write-only; kept in Vault). | ads.manage |
| GET | /v1/ads/tracking/events | The event debugger — every real outcome and what each ad network did with it. | ads.view |
| GET | /v1/ads/webhooks | The org's webhook endpoints and the Zinn® Ads events each one receives (za-192). | ads.view |
| PUT | /v1/ads/webhooks/{connection_id} | Choose which Zinn® Ads events a webhook endpoint receives (za-192). | ads.manage |
| POST | /v1/ads/webhooks/{connection_id}/test | Send one signed example of a Zinn® Ads event to a webhook endpoint (za-192). | ads.manage |
| GET | /v1/ads/wordpress/sites | The organisation's WordPress sites connected with the Zinn® Ads plugin. | ads.view |
| POST | /v1/ads/wordpress/sites | Make a one-time code that connects a WordPress site with the Zinn® Ads plugin. | ads.manage |
| DELETE | /v1/ads/wordpress/sites/{site_id} | Disconnect a WordPress site (its token stops working at once). | ads.manage |
| GET | /v1/ads/zaraz/connections | The organisation's Cloudflare zones connected for Zaraz. | ads.view |
| POST | /v1/ads/zaraz/connections | Connect one Cloudflare zone for Zaraz with a scoped token. | ads.manage |
| DELETE | /v1/ads/zaraz/connections/{connection_id} | Disconnect a Cloudflare zone (the stored token is deleted from Vault). | ads.manage |
| POST | /v1/ads/zaraz/connections/{connection_id}/check | Re-prove the stored token can read and edit Zaraz on the zone. | ads.manage |
| POST | /v1/ads/zaraz/connections/{connection_id}/install | One-click install - write the tracking hub's tools, triggers and consent into the zone. | ads.manage |
| GET | /v1/ads/zaraz/connections/{connection_id}/sync | The zone's sync state - drift against the agreed version and the hub, and the versions. | ads.view |
| POST | /v1/ads/zaraz/connections/{connection_id}/sync/adopt | Keep Cloudflare's version - it becomes the agreed version and its ids go back into the hub. | ads.manage |
| POST | /v1/ads/zaraz/connections/{connection_id}/sync/refresh | Read the zone now and compare it (nothing is written to Cloudflare). | ads.manage |
| POST | /v1/ads/zaraz/connections/{connection_id}/versions/{version_id}/restore | Undo - write an earlier version of the zone's Zaraz configuration back (30 days). | ads.manage |
| POST | /v1/ads/zaraz/zones | The Cloudflare zones a pasted Zaraz token can reach (the zone picker). | ads.manage |
| GET | /v1/public/ads-approvals/{token} | The agency client approval portal — what waits on the client's accounts. Unauthenticated. | Нема API кључа |
| POST | /v1/public/ads-approvals/{token}/changes/{change_id}/{action} | The agency's client approves or rejects one pending change. Unauthenticated. | Нема API кључа |
| GET | /v1/public/ads-tag/{public_key}.js | The universal Zinn® Ads script for one site (public, cached). | Нема API кључа |
| POST | /v1/public/ads-tag/{public_key}/signals | The universal tag's click-shield beacon (public, rate-limited, per-site key). | Нема API кључа |
| POST | /v1/public/ads-wordpress/claim | The Zinn® Ads plugin exchanges a one-time code for its site token. | Нема API кључа |
| POST | /v1/public/ads-wordpress/clicks | The plugin's click-fraud tag sends paid-click visits for scoring. | Сопствени токен |
| POST | /v1/public/ads-wordpress/heartbeat | The plugin reports in and reads its config. | Сопствени токен |
| POST | /v1/public/ads-wordpress/outcomes | The plugin sends the site's paid orders, free trials and sent forms to the outcome pipeline. | Сопствени токен |
| POST | /v1/public/ads-wordpress/refunds | The plugin withdraws or restates orders cancelled, failed or refunded after they were reported. | Сопствени токен |
| DELETE | /v1/public/ads-wordpress/site | The plugin's Disconnect button revokes its own site token. | Сопствени токен |
| GET | /v1/public/ads-wordpress/zaraz | The plugin's Zaraz step list - the zone connected for this site and what an install would write. | Сопствени токен |
| POST | /v1/public/ads-wordpress/zaraz/check | Re-check the connected zone's token and permissions, from wp-admin (writes nothing). | Сопствени токен |
| POST | /v1/public/ads-wordpress/zaraz/connect | Connect the Cloudflare zone serving this site for Zaraz, from wp-admin. | Сопствени токен |
| POST | /v1/public/ads-wordpress/zaraz/install | One-click install of the tracking hub into the site's zone, from wp-admin. | Сопствени токен |
| GET | /v1/public/ads/call-numbers/{pool_key} | The tracking number a site visitor from an ad is shown (dynamic number insertion). | Нема API кључа |
| GET | /v1/public/house-tags | The ad networks our own public sites load (public, cached). | Нема API кључа |
| POST | /v1/webhooks/ads-checkout/{source_id} | A checkout provider's signed delivery (Stripe, Paddle, Freemius). | Нема API кључа |
| POST | /v1/webhooks/ads-stock/{store_id} | A WooCommerce "Product updated" delivery for the out-of-stock pause (za-N2). | Нема API кључа |
| POST | /v1/webhooks/ads/telnyx-voice | Call events for Zinn® tracking numbers from our voice vendor (za-160). | Нема API кључа |