Skip to content

Add advertiser

This endpoint adds advertiser.

POST https://adelion.com/api/advertiser/add
ParameterTypeDescriptionRequirement
MailstringAdvertiser’s email.required
NamestringAdvertiser’s name.required
DescriptionstringAdvertiser’s description.optional
WebsitestringAdvertiser’s website.optional
CountrystringAdvertiser’s country. It must be a ISO-3166-1-alpha-2 country code. See Info -> Get countries for a list of available countries.required
CitystringAdvertiser’s city.optional
ZipCodestringAdvertiser’s zip code.optional
AddressstringAdvertiser’s address.optional
PhonestringAdvertiser’s phone.optional
MsgAppstringMessaging application: Teams, Telegram or WhatsApp.optional
MsgAccountstringMessaging account name on Messaging application.optional
UsernamestringAdvertiser’s username. It is required for fetching statistics through stats API or CSV export.required
JSON payload example
{
"Advertiser": {
"Mail": "advertiser@mail.com",
"Name": "Advertiser name",
"Description": "Advertiser desc",
"Website": "www.advertiser.com",
"Country": "US",
"City": "New York",
"ZipCode": "123456",
"Address": "123 Street",
"Phone": "+11111111111",
"MsgApp": "[msg_app]",
"MsgAccount": "[msg_account]",
"Username": "advertiser1"
}
}
Success JSON
{
"Status": "Ok",
"Advertiser": {
"Id": 15,
"TeamId": 1,
"Mail": "advertiser@mail.com",
"Name": "Advertiser name",
"Description": "Advertiser desc",
"Website": "www.advertiser.com",
"Country": "US",
"City": "New York",
"ZipCode": "123456",
"Address": "123 Street",
"Phone": "+11111111111",
"MsgApp": "[msg_app]",
"MsgAccount": "[msg_account]",
"Username": "advertiser1",
"StatsAuth": "7sdd23",
"StatsByDate": "https://adelion.com/api/ortb/stats/advertiser/general?username=advertiser1&auth=7sdd23&date_from={date_from}&date_to={date_to}&columns=DateStats,RemoteRequests,NetImpressions,Revenue",
"AccManagerId": 5,
"AccManagerName": "John Doe",
"Status": 0,
"StatusString": "Active",
"CampaignsCount": 0,
"DspRtbEpsCount": 0,
"DspVastTagsCount": 0,
"DspPopFeedsCount": 0
}
}
Error JSON
{
"Status": "Error",
"Error": "[error description]"
}
Error CodeMeaning
400Bad Request — You sent a body that isn’t JSON.
401Unauthorized — Your access token is invalid.
406Not Acceptable — Some value(s) inside JSON are missing or malformed, or requested object is not found.
500Internal Server Error — We had a problem with our server. Try again later.