AdnovaDocs
Ad Launcher

List ad accounts

Returns the org's Meta ad accounts onboarded to Ad Launcher. Use each id as the adAccountId in other endpoints. Pass ?q= to filter by name (case-insensitive substring).

GET
/meta/ad-accounts

Authentication

authentication
api-key<token>

Create an API key from the Adnova dashboard (Account integrations). Pass the key value in the api-key request header on every call.

In: header

Query Parameters

q?string

Case-insensitive substring match against accountName.

Header Parameters

x-workspace-id*string

Workspace the request operates in. Get it from List workspaces.

Length1 <= length
x-org-id*string

Organization context (required on every endpoint). For lookup endpoints the org is derived from the ad account in the URL, so any org id you have access to is accepted.

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.adnova.ai/ad-launcher/v1/meta/ad-accounts?q=spring" \  -H "x-workspace-id: string" \  -H "x-org-id: string"
{
  "data": [
    {
      "_id": "01H8Y4...",
      "id": "act_1234567890",
      "accountId": "1234567890",
      "accountName": "Acme - US - Prospecting",
      "currency": "USD",
      "timezone_name": "America/Los_Angeles",
      "workspaceId": [
        "01H8Y5..."
      ]
    }
  ]
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}