Omne's ads API

One vocabulary

| Omne's word | What it is on each platform | |---|---| | Account | An ad account | | Campaign | A campaign. On LinkedIn, a campaign group | | Ad set | An ad group. On LinkedIn, a campaign | | Ad | An ad. On LinkedIn, a creative |

• Ids are Omne's: reddit:a2_abc:123 says the platform, the ad account and the platform's own id. The ad account picks the platform, so you never name it twice.
• Money is in whole units of the ad account's currency, with the currency beside it. CTR is a percentage.
• Status is one of active, paused, draft, in_review, rejected, ended or archived. Whatever the platform said itself, its own status and its reason, stays under platform.

Every address, and which platform does it

| What | Address | Reddit | Pinterest | OpenAI | LinkedIn | Microsoft | TikTok | Meta | |---|---|---|---|---|---|---|---|---| | Ad accounts | GET /v1/ads/accounts | Yes | Yes | Yes | Yes | Yes | Soon | Soon | | Campaigns | GET /v1/ads/campaigns | Yes | Yes | Yes | Yes | Yes | Soon | Soon | | Ad sets | GET /v1/ads/ad-sets | Yes | Yes | Yes | Yes | Partly | Soon | Soon | | Ads with results | GET /v1/ads | Yes | Yes | Yes | Yes | Partly | Soon | Soon | | One campaign, ad set or ad | GET /v1/ads/campaigns/{id}<br>GET /v1/ads/ad-sets/{id}<br>GET /v1/ads/{id} | Yes | Yes | Yes | Yes | Yes | Soon | Soon | | The whole tree | GET /v1/ads/tree | Yes | Yes | Yes | Yes | Yes | Soon | Soon | | Each day's numbers | GET /v1/ads/timeline | Yes | Yes | Yes | Yes | Yes | Soon | Soon | | A campaign's, ad set's or ad's results | GET /v1/ads/campaigns/{id}/analytics<br>GET /v1/ads/ad-sets/{id}/analytics<br>GET /v1/ads/{id}/analytics | Yes | Partly | Yes | Yes | Partly | Soon | Soon | | Best and worst ads | GET /v1/ads/performance | Yes | Yes | Yes | Yes | No | Soon | Soon | | Totals across every platform | GET /v1/ads/totals | Yes | Partly | Yes | Yes | Yes | Soon | Soon | | What needs attention | GET /v1/ads/alerts<br>GET /v1/ads/accounts/health | Yes | Yes | Yes | Yes | Yes | Soon | Soon | | Audiences | GET /v1/ads/audiences | Yes | Yes | Yes | Yes | No | Soon | Soon | | Pixels and tags | GET /v1/ads/tracking-tags<br>GET /v1/accounts/{adAccountId}/tracking-tags | Yes | Yes | Yes | Yes | No | Soon | Soon | | Where conversions can go | GET /v1/ads/conversion-destinations<br>GET /v1/accounts/{adAccountId}/conversion-destinations | Yes | Yes | Yes | Yes | No | Soon | Soon | | Saved event destinations | GET /v1/events/destinations | Yes | Yes | Yes | Yes | No | Soon | Soon | | Find targeting | GET /v1/ads/targeting/search | Partly | No | Partly | Partly | No | Soon | Soon | | Audience size | POST /v1/ads/targeting/reach-estimate | No | No | No | Yes | No | Soon | Soon | | Lead forms | GET /v1/ads/lead-forms | No | No | No | Yes | No | Soon | Soon | | Leads | GET /v1/ads/leads<br>GET /v1/ads/lead-forms/{formId}/leads | No | No | No | Yes | No | Soon | Soon | | An ad's comments | GET /v1/ads/{id}/comments | No | No | No | No | No | Soon | Soon | | Which platform does what | GET /v1/ads/support | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | Pause or resume | PUT /v1/ads/campaigns/{id}/status<br>PUT /v1/ads/ad-sets/{id}/status<br>PUT /v1/ads/{id}/status | Yes | Yes | Yes | Yes | Partly | Soon | Soon | | Pause or resume many campaigns | POST /v1/ads/campaigns/bulk-status | Yes | Yes | Yes | Yes | Yes | Soon | Soon | | Rename or change a budget | PUT /v1/ads/campaigns/{id}<br>PUT /v1/ads/ad-sets/{id}<br>PUT /v1/ads/{id} | Partly | Yes | Partly | Yes | Partly | Soon | Soon | | Copy | POST /v1/ads/campaigns/{id}/duplicate<br>POST /v1/ads/ad-sets/{id}/duplicate<br>POST /v1/ads/{id}/duplicate | No | No | No | Partly | No | Soon | Soon | | New campaign | POST /v1/ads/campaigns | Yes | Yes | Yes | Yes | No | Soon | Soon | | New ad set | POST /v1/ads/ad-sets | Yes | Yes | Yes | Yes | No | Soon | Soon | | New ad | POST /v1/ads/create | Yes | Yes | Yes | Yes | No | Soon | Soon | | Archive | DELETE /v1/ads/campaigns/{id}<br>DELETE /v1/ads/ad-sets/{id}<br>DELETE /v1/ads/{id} | Yes | Yes | Yes | Yes | No | Soon | Soon | | Send conversions to one destination | POST /v1/ads/conversions | Yes | Yes | Yes | Yes | No | Soon | Soon | | Send events to every destination | POST /v1/events | Yes | Yes | Yes | Yes | No | Soon | Soon | | Save an event destination | POST /v1/events/destinations | Yes | Yes | Yes | Yes | No | Soon | Soon | | Forget an event destination | DELETE /v1/events/destinations/{id} | Yes | Yes | Yes | Yes | No | Soon | Soon |

Partly means this:

• Microsoft, ad sets: 25 campaigns' ad groups a call
• Microsoft, ads with results: 40 ad groups' ads a call
• Pinterest, a campaign's, ad set's or ad's results: the last 90 days
• Microsoft, a campaign's, ad set's or ad's results: campaigns only, no breakdowns
• Microsoft, best and worst ads: results come by campaign
• Pinterest, totals across every platform: the last 90 days
• Reddit, find targeting: communities
• Pinterest, find targeting: its targeting takes its own codes on the ad set
• OpenAI, find targeting: places
• LinkedIn, find targeting: every LinkedIn facet
• Reddit, an ad's comments: comments are the post's, on Reddit
• Pinterest, an ad's comments: not in its ads API
• OpenAI, an ad's comments: chat cards take no comments
• LinkedIn, an ad's comments: not in Omne yet
• Microsoft, an ad's comments: search ads take no comments
• Microsoft, pause or resume: an ad set needs its campaign, an ad its ad set and type (parentId, type)
• Reddit, rename or change a budget: a budget keeps its type (daily or lifetime)
• OpenAI, rename or change a budget: budgets on campaigns
• Microsoft, rename or change a budget: a campaign's daily budget
• LinkedIn, copy: a LinkedIn campaign (Omne's ad set), with its ads

Soon means the platform isn't connected to Omne yet. When a platform can't do something, the answer says so in plain words with a 501. Omne never sends back an empty stand-in.

Totals across every platform

GET /v1/ads/totals adds up spend, impressions, clicks, conversions and ROAS across every connected ad account in one call, with each platform's and each account's share, and each day when you pass daily=true. Two currencies are never added together: each currency has its own total.

Changes, and what they spend

Everything that reads runs at once. Every change waits for your yes in Omne AI, and anything that can spend or can't be undone waits even in Auto.

• Whatever Omne makes starts paused, and on LinkedIn as a draft, so nothing spends until you turn it on.
• DELETE archives, because none of these platforms deletes a campaign, ad set or ad that has run.
• Through the API, changes need a key made to write.

Conversions

POST /v1/ads/conversions sends events to one destination. POST /v1/events sends them once and forwards them to every destination you saved with POST /v1/events/destinations, each answering for itself. Omne hashes email, phone, names and ids the way each platform asks, and an eventId stops a sale counting twice.

Webhooks

Set them up in Settings → MCP & API → Webhooks. For every ad platform above, Omne sends account.connected, account.disconnected, account.needs_reconnect, account.ads.initial_sync_completed and ad.status_changed. Omne reads each connection every hour, so a change made in the platform's own ads manager reaches you within the hour.

Platform-only features

What only one platform does keeps its own tool beside these, such as LinkedIn's forecasts, bid pricing, Ad Library and Matched Audiences, Reddit's profiles, and OpenAI's audit log. Each platform's page lists its own addresses, and they all keep working.

Related: Reddit Ads, Pinterest Ads, OpenAI Ads, LinkedIn Ads and Omne's API.