Authentication

Base URL

https://api.withgrowl.com/v1/adm

Bearer authentication

Send your Elo Ads API key in the Authorization header on every request:

Authorization: Bearer $ELO_ADS_API_KEY

The key is scoped to one ad account. Requests can only access objects owned by that account.

Keep the key in a server-side secret store or environment variable. Do not embed it in a website, mobile app, public repository, log, or analytics event.

Retrieve the current ad account

Use this endpoint to confirm that a key works and identify its ad account.

GET /ad_account

curl "https://api.withgrowl.com/v1/adm/ad_account" \
  -H "Authorization: Bearer $ELO_ADS_API_KEY" \
  -H "Accept: application/json"

{
  "id": "67f47f965c61f3e66f163c21",
  "name": "Acme Ads",
  "created_at": 1744070400
}

Field	Type	Description
id	string	The ad account ID.
name	string	The ad account name.
created_at	integer	Creation time as a Unix timestamp in seconds.

Authentication errors

A missing or invalid key returns 401:

{
  "error": {
    "message": "Missing or invalid API key in Authorization header.",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_api_key"
  }
}