API
HQ APIAd campaigns

Create an ad campaign

Creates a new ad campaign with status active. Create equals submit — ads are transitioned to in_review as part of the request.

POST/v1/hq/ad_campaigns
AuthorizationBearer <token>

The Noona HQ API uses Bearer token for authentication.

Endpoints that return generic information that does not contain sensitive data do not require authentication. Endpoints that require authentication are specifically marked in the documentation.

Authorization: Bearer your-token

In: header

Query Parameters

select?array<string>
expand?array<string>

Request Body

application/json

company_id*string
name*string
budget*
schedule?
targeting?
promotables*

Response Body

application/json

curl -X POST "https://api.noona.is/v1/hq/ad_campaigns" \  -H "Content-Type: application/json" \  -d '{    "company_id": "string",    "name": "string",    "budget": {},    "promotables": [      {}    ]  }'
{
  "id": "string",
  "company": "string",
  "name": "string",
  "status": "active",
  "budget": {
    "daily": {
      "amount": 10000,
      "currency": "ISK"
    },
    "total": {
      "amount": 500000,
      "currency": "ISK"
    }
  },
  "schedule": {
    "starts_at": "2019-08-24T14:15:22Z",
    "ends_at": "2019-08-24T14:15:22Z"
  },
  "targeting": {
    "location": {
      "lat": 0.1,
      "lng": 0.1
    },
    "radius": 0
  },
  "promotables": [
    {
      "type": "ad",
      "ad": {
        "ad_id": "string"
      }
    }
  ],
  "spend": {
    "total": {
      "amount": 50000,
      "currency": "ISK"
    },
    "today": {
      "amount": 5000,
      "currency": "ISK"
    },
    "today_date": "string"
  },
  "paused_for_day": true,
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "effective_status": "pending_review",
  "starts_at": "2019-08-24T14:15:22Z"
}
Empty
Empty
Empty
Empty
Empty