API reference
ads
12 endpoints in this area. Each one has its own page with its parameters, its response and a request you can run.
| Method | Path | What it does | Permission |
|---|---|---|---|
| GET | /v1/ads/changes | The approve-first queue and the change history. | ads.view |
| POST | /v1/ads/changes/{change_id}/{action} | Approve, reject or undo one change. | 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. | No API key |
| 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 |
| GET | /v1/ads/connections | The organisation's connected ad accounts. | ads.view |
| PATCH | /v1/ads/connections/{connection_id} | Rename, pause (the account's kill switch), set modes or spend ceilings. | ads.manage |
| POST | /v1/ads/connections/{connection_id}/disconnect | Disconnect an ad account; its token and all its data are deleted. | 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 |
| POST | /v1/ads/email-actions | Act on an e-mailed Approve or Undo link (signed in). | ads.manage |