API reference

Ad Campaigns API

Every ad campaigns operation in the public API, from the OpenAPI spec. Base URL https://api.outlevo.com; the organization comes from the key.

GET /v1/ad-campaigns	The ad campaigns overview: connections, platforms and their availability, caps, kill switch, test sets with spend and results, the wallet
DELETE /v1/ad-campaigns/{platform}/managed	Managed ads: turn a platform off
POST /v1/ad-campaigns/{platform}/managed	Managed ads: Outlevo runs this platform from its own ad account (a monthly add-on; without confirm=true in the body, the price only)
POST /v1/ad-campaigns/{platform}/managed/access	Managed ads: say the workspace gave Outlevo access on the platform (the page, profile or handle the ads run as)
POST /v1/ad-campaigns/ads/{id}/approve	Approve an ad (owner or marketing approver)
POST /v1/ad-campaigns/ads/{id}/reject	Reject an ad, with the reason
POST /v1/ad-campaigns/ads/{id}/rewrite	Write a rejected ad again (free, twice an ad at most); the checks run again
POST /v1/ad-campaigns/angles/suggest	Suggest ad angles from the workspace's business context
PUT /v1/ad-campaigns/caps/{platform}	Daily and monthly spend caps for a platform (owner or marketing approver)
DELETE /v1/ad-campaigns/connections/{id}	Disconnect a campaign connection (pause its running ads first)
PUT /v1/ad-campaigns/connections/{id}	Pick a campaign connection's ad account and what its ads need
GET /v1/ad-campaigns/connections/{id}/choices	What a campaign connection can pick: ad accounts, and for `account` its pages, pixels, profiles or payment methods
PUT /v1/ad-campaigns/connections/{id}/conversion-token	Reddit: the conversion access token from Events Manager (null removes it)
POST /v1/ad-campaigns/kill-switch	Stop every ad now (on), or release the stop (off; owner or admin)
PUT /v1/ad-campaigns/settings	Whether the first ad of each test set needs approval, and whether ready test sets launch by themselves
POST /v1/ad-campaigns/test-sets	Order a test set of ads for an angle (credits: without ?confirm=true, the quote only)
GET /v1/ad-campaigns/test-sets/{id}	A test set: its ads, their status, placements, spend and results
POST /v1/ad-campaigns/test-sets/{id}/launch	Launch a ready test set, or restart a paused one (runs in the worker, inside the caps)
POST /v1/ad-campaigns/test-sets/{id}/pause	Pause a test set's running ads