Getting started
How to authenticate and make your first Adnova API call.
1. Get an api-key
Create an API key from the Adnova app and store it like a credential: anyone who has it can call the API with your visibility into organizations, workspaces, and ad accounts.
Go to Account integrations to create or rotate API keys.
All endpoints require the key in the api-key header:
api-key: YOUR_KEY_HERE2. Discover your ad accounts (Analytics)
Use the Manage API to list the organizations and workspaces your key can access, then list ad accounts with the Analytics API. Follow these references in order:
3. Fetch insights (Analytics)
After you know which ad account to query, use the Analytics API for metric catalogs, supporting metadata, and insights. List Fetch ad insights last — it often builds on the others (metrics, tags, naming).
4. Launch ads (Ad Launcher)
To push ads into Meta programmatically — upload a creative, submit a launch, poll for status — use the Ad Launcher API. Read the overview first, then the references in order:
- Upload a creative → Complete creative upload
- List ad accounts, List adsets, List ad profiles
- Create a launch → Get launch
Ad Launcher requires two extra headers on every request alongside api-key:
x-workspace-id: YOUR_WORKSPACE_ID
x-org-id: YOUR_ORG_IDBoth x-workspace-id and x-org-id are required on every Ad Launcher endpoint.
