Create Campaign limit

POST /campaigns/{id}/limits
Copied
Arrow
                https://api.ocamba.com/v2/adex/campaigns/{id}/limits

Creates a new Campaign limit object

path Parameters
Arrow
Name
Description
idstringrequired
Unique identifier for the object defined as a path parameter.


Example: 12345
Response status codes
Arrow
201 - Created
Arrow
Name
Description
itemstringrequired
Represents the subtype of the campaign limit. Possible values depend on type of limit.


Example: impressions

Possible values: income | expense | impressions | clicks | conversions
periodstringrequired
Describes the period of the limit.


Example: hour

Possible values: hour | day | month | lifetime
typestringrequired
Describes a type of the campaign limit.


Example: frequency

Possible values: frequency | budget
valuenumberrequired
A number between 1 and 4000000000.


Example: 1000
warning
1 Limit of type budget can have the item field set as 'expense' or 'income'. Limit of type frequency can have the item field set as 'clicks', 'impressions' or 'conversions'.
Request examples
Copied
Arrow
frequency Arrow
  • frequency
  • budget
{
  "type": "frequency",
  "item": "impressions",
  "period": "hour",
  "value": 1000
}

{
  "type": "budget",
  "item": "expense",
  "period": "day",
  "value": 1000
}
Response examples
Copied
Arrow
201 Arrow
  • 201
  • 201
{
  "id": "10553",
  "company_id": "2313200",
  "campaign_id": "1052233",
  "type": "frequency",
  "item": "impressions",
  "period": "hour",
  "value": 1000
}

{
  "id": "1612",
  "company_id": "6197120",
  "campaign_id": "1012346",
  "type": "frequency",
  "item": "impressions",
  "period": "hour",
  "value": 1000,
  "create_time": "2021-10-29 15:40:10",
  "update_time": "2021-10-29 15:40:10"
}