Create Account limit

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

Creates a new Account limit object

path Parameters
Arrow
Name
Description
account_idstringrequired
Unique account identifier defined as a path parameter.


Example: 12345
Request Body Schema
Arrow
Name
Description
itemstringrequired
Depends on the type. If type is budget allowed values are income and expense. If type is frequency allowed values are: impressions, clicks and conversions.


Example: income

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


Example: day

Possible values: hour | day | month | lifetime
typestringrequired
Represent the type of the account limit.


Example: budget

Possible values: budget | frequency
valueintegerrequired
Value of the upper limit.


Example: 1
Response status codes
Arrow
201 - Created
Arrow
note
1 Unique constraint is defined on a combination of the following fields: type, item and period. If you try to create two AccountLimit objects with same values on this combination of fields, the second object will be considered as `Duplicate entry` and your request will be rejected.
Request examples
Copied
Arrow
frequency-type-limit Arrow
  • frequency-type-limit
  • budget-type-limit
{
  "type":"frequency",
  "item":"clicks",
  "period":"day",
  "value": 120
}

{
  "type":"budget",
  "item":"income",
  "period":"day",
  "value": 161
}
Response examples
Copied
Arrow
201 Arrow
  • 201
{
  "id": "2084",
  "company_id": "1234543",
  "account_id": "16274541",
  "type": "frequency",
  "item": "clicks",
  "period": "day",
  "value": 120
}