List campaigns


https://dash.stannp.com/api/v1/campaigns/list
Request
$ curl https://dash.stannp.com/api/v1/campaigns/list?api_key={API_KEY}
Toggle Response
{
   "success":true,
   "data":[
      {
         "id":"222",
         "account_id":"9",
         "name":"a5 test",
         "template_id":"0",
         "type":"a5-postcard",
         "trigger_date":null,
         "send_date":null,
         "trigger_offset":null,
         "created":"2015-04-26T10:40:00Z",
         "updated":"2015-04-26T10:40:00Z",
         "status":"draft",
         "recipients_group":"0",
         "recipients_filter":"",
         "recipients_validated":"valid",
         "recipients":"0",
         "recipients_not_valid":"0",
         "dispatched":"0",
         "cost":"0.00",
         "voucher_code":"",
         "image":null
      },
      {
         "id":"221",
         "account_id":"9",
         "name":"April Campaign",
         "template_id":"195",
         "type":"a6-postcard",
         "trigger_date":null,
         "send_date":null,
         "trigger_offset":null,
         "created":"2015-04-26T10:15:40Z",
         "updated":"2015-04-26T10:15:40Z",
         "status":"draft",
         "recipients_group":"0",
         "recipients_filter":"",
         "recipients_validated":"valid",
         "recipients":"0",
         "recipients_not_valid":"0",
         "dispatched":"0",
         "cost":"0.00",
         "voucher_code":"",
         "image":"https://dash.stannp.com/api/v1/uploads/9/image-1430044053.jpg"
      }
   ]
}

Get a single campaign


https://dash.stannp.com/api/v1/campaigns/get/:id
Request
$ curl https://dash.stannp.com/api/v1/campaigns/get/1234?api_key={API_KEY}
Toggle Response
{
   "success":true,
   "data":{
      "id":"126",
      "name":"Stannp Test Campaign",
      "template_id":"111",
      "type":"a6-postcard",
      "trigger_date":null,
      "send_date":null,
      "trigger_offset":null,
      "created":"2015-03-17 11:04:19",
      "updated":"2015-03-20 10:57:05",
      "status":"dispatched",
      "recipients_group":"15",
      "recipients_filter":"",
      "recipients_validated":"valid",
      "recipients":"232",
      "recipients_not_valid":"0",
      "updated":"2015-03-21 09:10:05",
      "cost":"0.00",
      "voucher_code":"",
      "image":"https://dash.stannp.com/api/v1/uploads/9/image-1426590259.jpg",
      "size":"A6"
   }
}

Create a new campaign


https://dash.stannp.com/api/v1/campaigns/create

Parameters

name string Name your campaign for reference.
type a6-postcard | a5-postcard | letter The type of campaign this will be.
template_id int A template ID to make a copy of. If left out or set to "0" then a blank template of the correct format will be used.
group_id int A group id
what_recipients all | valid | not_valid | int What recipients do you want this campaign to go to?
"all" is every recipient in the group
"valid" send to only UK validated addresses
"not_valid" send to only UK non validated addresses
"int" send to only international addresses
addons string If you have an addon code.
Request
$ curl https://dash.stannp.com/api/v1/campaigns/create?api_key={API_KEY} \
-d "name=My Campaign" \
-d "type=a6-postcard" \
-d "template_id=12345" \
-d "group_id=12345" 
Response
{
   "success":true,
   "data":{
      "id":"266"
   }
}

Produce a sample


https://dash.stannp.com/api/v1/campaigns/sample

Parameters

id int The id of the campaign to produce a sample for
Request
$ curl https://dash.stannp.com/api/v1/campaigns/sample?api_key={API_KEY}
-d "id=123" \
Response
{
   "success":true,
   "data":"https://stannpstorage.blob.core.windows.net/pdf-samples/12345_12345678_sample_11234567890-GDBNYWVCJBJIBVGGVC.pdf"
}

Approve a campaign

When approving a campaign you take full responsibility for any spelling mistakes or design flaws. Once approved we will select all recipient data at this point and future changes to the same data will not apply to this campaign. This campaign will then be locked so you will be unable to makes changes to the design or recipient selection.
https://dash.stannp.com/api/v1/campaigns/approve

Parameters

id int The id of the campaign to approve
Request
$ curl https://dash.stannp.com/api/v1/campaigns/approve?api_key={API_KEY}
-d "id=123" \
Response
{
   "success":true,
   "data":{}
}

Campaign Cost


https://dash.stannp.com/api/v1/campaigns/cost

Parameters

id int The id of the campaign to find out the cost of booking
Request
$ curl https://dash.stannp.com/api/v1/campaigns/cost/?api_key={API_KEY}
-d "id=123" \
Response
{
   "success":true,
   "data": {
        "rate": "0.41",
        "non_valid_rate": "0.51",
        "delivery_rate": "0.00",
        "international_rate": "0.00",
        "valid": "14.35",
        "not_valid": "191.25",
        "international": "0.00",
        "delivery_charge": "0.00",
        "net": "205.60",
        "vat": "41.12",
        "total": "246.72"
   }
}

Book a campaign

When booking your campaign payment will be taken from your balance.
https://dash.stannp.com/api/v1/campaigns/book

Parameters

id int The id of the campaign to delete
send_date string The dispatch date of the campaign. Must be in a YYYY-MM-DD format. eg: 2019-12-08
use_balance bool Set to true to use your balance to pay for the campaign. If you do not pay for the campaign using balance the campaign will be scheduled but will not be posted till payment.
Request
$ curl https://dash.stannp.com/api/v1/campaigns/book?api_key={API_KEY}
-d "id=123" \
-d "send_date=2019-12-08" \ 
-d "use_balance=true"
Response
{
   "success":true,
   "data":true
}

Delete a campaign


https://dash.stannp.com/api/v1/campaigns/delete

Parameters

id int The id of the campaign to delete
Note that this will permanently delete the campaign.
Request
$ curl https://dash.stannp.com/api/v1/campaigns/delete?api_key={API_KEY}
-d "id=123" \
Response
{
   "success":true,
   "data":{}
}