Create Wallet

Creates a wallet for your network with a name, a currency and a Limit.

Creates a wallet with a Balance of 0 and no Advertiser. Assign it to an Advertiser, then link it to Campaigns. See Wallets.

API syntax

POST https://api.kevel.co/v1/wallet

Request

  • Name, Currency and Limit are required.
  • Currency must be your network's wallet currency.
  • IsActive defaults to true.
  • Fields the endpoint does not recognize return 400.

Errors

StatusMessageWhat to do
400Configure wallet currency for this network before creating wallets.Ask your Kevel representative to set it.
400A message naming Currency.Use an uppercase ISO 4217 code, such as USD.
400Currency does not match this network's wallet currency.Use your network's wallet currency.
Body Params
string
required
length ≤ 200

The wallet's name.

string
required

The ISO 4217 code, in uppercase. It must match your network's wallet currency and cannot be changed.

integer
required

The Balance at which linked Campaigns stop. A whole number in the wallet's currency. It can be positive, zero or negative.

integer | null

Kevel Console shows the Low status and sends a notification when Available (Limit minus the Balance) is at or below this. Ad serving ignores it. Omitted when not set.

string | null

Your own reference for the wallet, such as a purchase order number. Omitted when not set.

boolean
Defaults to true

Defaults to true. false creates the wallet switched off.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json