Skip to content

Authentication

Create an API key in the dashboard settings (API keys) and send it in the x-api-key header of every request:

Terminal window
curl https://ads.wortise.com/api/public/v1/session \
-H "x-api-key: wads_..."

Keys start with wads_ and belong to one organization.

Each key carries scopes per resource:

Resource Scopes
campaigns read, write, launch
creatives read, write
assets read, write
inventory read

Ad groups are part of their campaign and use the campaigns scopes.

Scopes only narrow what a key can do: a request also needs the dashboard permission of the member that owns the key. A request without the scope or the permission answers 403.

GET /session returns the key owner, organization and scopes.