API documentation

Subject

Getting started

Authentication

All requests to the Adsroid API require authentication using your API key.
Each key is linked to your workspace and includes usage limits based on your subscription and available credits.

Your Organisation API Key

Each organisation can have only one active API key at a time.
You can find it in your Adsroid dashboard under:
Settings → API Key

This key must be sent inside the Authorization header using the format:

Authorization: bearer YOUR_API_KEY

Your Organisation ID

This identifies which organisation is making the request.
You can find it in:
Settings → Organisation ID

Your Project ID

Since an organisation can manage multiple projects, you must specify the project the request should apply to.

You can find it in each project’s settings under:
Project → Settings → Project ID

API Endpoint
Adsroid Agent API
Online
POST https://api.adsroid.com/agent
Send requests to the Adsroid AI Agent to analyze campaigns, generate recommendations and automate workflows.
✓ Google Ads ✓ Meta Ads ✓ AI Agent ✓ Automation
Request Headers
Authentication
🔒 Secure
authorization: Bearer adr_b80101ab-xxxxxxxxxxxxxxxxxx

content-type: application/json
Include your Adsroid API key in every request using the authorization header.
authorization Your organisation API key using the Bearer authentication scheme.
content-type Requests must be sent as JSON.
Request Body
JSON Payload
JSON
{
  "organisation_id": "3f938ddc-xxxxxxxxxxxxxxxxxx",

  "project_id": "0392b0c1-xxxxxxxxxxxxxxxxxx",

  "message": "Analyse my Google Ads campaigns"
}
Define the organisation, project and instruction sent to the Adsroid AI Agent.
organisation_id The unique identifier of your Adsroid organisation.
project_id The project context the request should be executed against.
message The prompt, instruction or question sent to the Adsroid AI Agent.

Response

The API returns the agent’s response exactly as if you used the Adsroid interface — but fully automatable and compatible with Make, Zapier, n8n, and any backend.