POST /v1/entity/advertiser/upsell

NOTE: This method is not accessible to users on Starter Plan API keys. Please contact us if you want premium access to our service

HTTP Method: POST

Path:  /v1/entity/advertiser/upsell

Authentication: API Key required, User ID required

Description: Upsell (add extra coverage) to an existing advertiser

Parameters:

 

Parameter Type Mandatory Description Example
api_key string yes The user API key k5er678uyrt54er
_user_id string yes The user user_id ax34er6tt65edr
publisher_id string yes The id of the “publisher” of the advert w4wer445t5gpo688
entity_id string yes The entity ID where advertiser object will be inserted. 45679321234
extra_tags integer yes number of additional searchable tags allowed 5
extra_locations integer yes number of additional searchable locations allowed 5
is_national boolean no whether the advert is national coverage. Default is FALSE  
tags string no comma-separated list of searchable tags boiler repair, boiler installation
locations string no comma-separated list of valid location ids 145678, 123476
reseller_ref string yes A sales reference in the seller's systems (to help with reporting) JP123
reseller_agent_id string yes Reference to the identity of reseller agent Johnny Sales

 

Sample Success Response:

{
    "success": true,
    "msg": "ok",
    "data": {
        "ok": true,
        "id": "379275323781120",
        "rev": "29-f8659797282cbbfffa92c20731486e38"
    }
}

Docs Navigation