JSON response format — https://api.vbout.com/1/emailmarketing/addcontact.json XML response format — https://api.vbout.com/1/emailmarketing/addcontact.xml
key — Unique API user key from vbout account - required listid — List id of which this contact belong too - required email — Email address of the contact to return - required status — Status of the contact (active | disactive) - required ipaddress — Inject the visitor's ip into the Vbout tracker to merge the tracking done on that ip. Must be used with an active Vbout tracking code - optional fields — Custom fields added to a specific list (Array) - optional
Note: You can get your api key, listid on your vbout account. You can get custom fields using List Details method.
Step 1. Copy the code below. If you are to use PHP, copy the PHP sample. If you are to use Javascript or jQuery, use the Javascript sample. Step 2. Change the parameter values, the codes highlighted in red. Step 3. You can now check the returned data stored in a variable named response, if the request was successful.
[{ "data" : { "item" : "Your contact has been created successfully.", 'id' => '220025636', } }]
Getting contact details by email.
JSON response format — https://api.vbout.com/1/emailmarketing/getcontactbyemail.json XML response format — https://api.vbout.com/1/emailmarketing/getcontactbyemail.xml
key — Unique API user key from vbout account - required email — Email address of the contact to return - required listid — List id of which this contact belong too - required
Note: You can get your api key and listid value on your vbout account.
Step 1. Copy the code below. If you are to use PHP, copy the PHP sample. If you are to use Javascript or jQuery, use the Javascript sample. Step 2. Change the parameter values, the codes highlighted in red. Step 3. You can now manipulate the returned data stored in a variable named details.
JSON response format — https://api.vbout.com/1/emailmarketing/editcontact.json XML response format — https://api.vbout.com/1/emailmarketing/editcontact.xml
key — Unique API user key from vbout account - required id — ID of the contact to update - required listid — List id of which this contact belong too - required email — Email address of the contact to return - required status — Status of the contact (active | disactive) - required fields — Custom fields added to a specific list (Array) - optional
Note: You can get your api key, listid, and custom fields on your vbout account. You can get contact id using Get Contact method.
Step 1. Copy the code below. If you are to use PHP, copy the PHP sample. If you are to use Javascript or jQuery, use the Javascript sample. Step 2. Change the parameter values, the codes highlighted in red. Step 3. You can now check the returned data stored in a variable named response, if the request was successful.
[{ "data" : { "item" : "Your contact has been updated successfully.", } }]
Deleting an existing contact to a list.
JSON response format — https://api.vbout.com/1/emailmarketing/deletecontact.json XML response format — https://api.vbout.com/1/emailmarketing/deletecontact.xml
key — Unique API user key from vbout account - required id — ID of the contact to delete - required
Note: You can get your api key on your vbout account. You can get contact id using Get Contact method.
Step 1. Copy the code below. If you are to use PHP, copy the PHP sample. If you are to use Javascript or jQuery, use the Javascript sample. Step 2. Change the parameter values, the codes highlighted in red. Step 3. You can now check the returned data stored to a variable named response, if the request was successful.
var params = { "key" : '234562345623456', "id" : '3', }; $.ajax({ url : "https://api.vbout.com/1/emailmarketing/deletecontact.json", type : "POST", data : params, success: function (res) { var response = res.response.data.item; alert(response); } });
[{ "data" : { "item" : "Your contact has been deleted successfully.", } }]
Getting list details, including custom fields.
JSON response format — https://api.vbout.com/1/emailmarketing/getlist.json XML response format — https://api.vbout.com/1/emailmarketing/getlist.xml
key — Unique API user key from vbout account - required id — ID of the list to return - required
Note: You can get your api key and listid on your vbout account.
Step 1. Copy the code below. If you are to use PHP, copy the PHP sample. If you are to use Javascript or jQuery, use the Javascript sample. Step 2. Change the parameter values, the codes highlighted in red. Step 3. You can now check the returned data stored to a variable named details, if the request was successful.
var params = { "key" : '234562345623456', "id" : '12345', }; $.ajax({ url : "https://api.vbout.com/1/emailmarketing/getlist.json", type : "POST", data : params, success: function (res) { var details = res.response.data.list; $.each(details,function(key,value){ alert(key+' = '+value); }); } });
foreach($details as $key => $value){ echo $key.' = '.$value.'<br>'; }
[{ "data" : { "list" : { "id" : "12345", "name" : "Subscription form", "form_title" : "Newsletter Signup", "email_subject" : "Thank you for your subscription.", "reply_to" : "support@website.com", "from_email" : "admin@website.com", "from_name" : "Admin", "confimation_email" : "Please click on the link below to confirm your subscription.", "success_email" : "Your email is now confirmed! we are excited to have you on our list.", "confimation_message" : "Your signup is almost complete! Check your email for a confirmation message.", "success_message" : "Your subscription is now complete!", "error_message" : "You have already been subscribed to this list!", "doubleOptin" : "0", "notify_email" : "", "creation_date" : "11/06/2014 00:00", "fields" : { "1125" :"First Name", "1126" :"Last Name", "1127" :"Phone" } }, } }]