Vbout.com

GET app/me

Resource URL

https://api.vbout.com/1/app/me

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

None

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/ApplicationWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new ApplicationWS($user_key);
    $results = $app->getBusinessInfo();

    print_r($results);
?>
GET https://api.vbout.com/1/app/me.json?key={YOUR_API_ID}

Example Response

{
   "business": {
		"businessName": "Loft Hotels",
		"contactName": "Paul Downy",
		"phoneNumber": "212-400-7133",
		"vboutName": "Loft-corporate",
		"package": "Franchise"
	  }
}

GET reputation/direct

Resource URL

https://api.vbout.com/1/reputation/direct

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

filter
optional

The timeline which the reviews are returned.

Possible Values: today | lastweek | lastmonth | date
Default: today

from
optional

The from date which the reviews are returned. The filter must be 'date' for this parameter to work.

Possible Values: (Date)
Date format accepted: m/d/Y | Y-m-d
Default: (None)

to
optional

The to date which the reviews are returned. The filter must be 'date' for this parameter to work.

Possible Values: (Date)
Date format accepted: m/d/Y | Y-m-d
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/ReputationWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new ReputationWS($user_key);
    $parms = array(
        'filter' => 'today',
    );

    $results = $app->getDirectReviews($parms);

    print_r($results);
?>
GET https://api.vbout.com/1/reputation/direct.json?filter=date&from=2013-01-01&to=2014-01-01&api_key={YOUR_API_ID}

Example Response

{
"reviews": {
"count": 5,
"items": [
  {
	"id": "163",
	"email": "richi.rich@gmail.com",
	"phone": "917-400-7121",
	"date": "12/31/2013",
	"time": "19:00 PM",
	"inquiry": "This was the best meal i ever had. New management is doing a great job, keep it up!",
	"notes": "Jane sent him a bday coupon.",
	"rating": "Good"
  },
  {
	"id": "182",
	"email": "info@vbout.com",
	"phone": "",
	"date": "12/31/2013",
	"time": "19:00 PM",
	"inquiry": "I loved the front entrance, the decore was great!",
	"notes": "",
	"rating": "Good"
  },
  {
	"id": "183",
	"email": "dan@lasersharp.com",
	"phone": "",
	"date": "12/31/2013",
	"time": "19:00 PM",
	"inquiry": "the food was horrible!",
	"notes": "Contacted the customer but never heard back",
	"rating": "Bad"
  },
  {
	"id": "184",
	"email": "rich@vbout.com",
	"phone": "",
	"date": "12/31/2013",
	"time": "19:00 PM",
	"inquiry": "thank you for the great experience",
	"notes": "came through a facebook ad",
	"rating": "Good"
  },
  {
	"id": "202",
	"email": "imad@yopmail.com",
	"phone": "",
	"date": "12/31/2013",
	"time": "19:00 PM",
	"inquiry": "Server was soso but food was exceptional.",
	"notes": "followed up with servers on shift that night and gave them a warning.",
	"rating": "Good"
  }
]
}
}

GET reputation/online

Resource URL

https://api.vbout.com/1/reputation/online

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

channels
optional

The channels from which the reviews are gathered.

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/ReputationWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new ReputationWS($user_key);
    $parms = array(
        'channels' => 'all',
    );

    $results = $app->getOnlineReviews($parms);

    print_r($results);
?>
GET https://api.vbout.com/1/reputation/online.json?channels=citysearch,googleplaces,zagat&api_key={YOUR_API_ID}

Example Response

{
"reviews": {
	"count": 2,
	"items": {
	  "CitySearch": {
		"AvgRating": "0"
	  },
	  "GooglePlaces": {
		"AvgRating": null,
		"data": [
		  {
			"username": "Reina Martinez",
			"date": "1371004538",
			"inquiry": "",
			"rating": "a:1:{i:0;a:2:{s:6:\"rating\";i:0;s:4:\"type\";s:7:\"quality\";}}",
			"sourceUrl": "https://plus.google.com/100567111539474362108/about?hl=en"
		  },
		  {
			"username": "Andrea Tassone",
			"date": "1394025796",
			"inquiry": "Not so good",
			"rating": "a:1:{i:0;a:2:{s:6:\"rating\";i:0;s:4:\"type\";s:7:\"quality\";}}",
			"sourceUrl": "https://plus.google.com/100567111539474362108/about?hl=en"
		  }
		]
	  },
	  "Zagat": {
		"AvgRating": "0"
	  }
	}
  }
}

GET reputation/getfeedback

Resource URL

https://api.vbout.com/1/reputation/getfeedback

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The numerical ID of the review.

Possible Values:(ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/ReputationWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new ReputationWS($user_key);

    $id = '23';
    $results = $app->getMyFeedback($id);

    print_r($results);
?>
GET https://api.vbout.com/1/reputation/getfeedback.json?id=163&api_key={YOUR_API_ID}

Example Response

{
"item": [
{
  "id": "163",
  "email": "info@siteforbiz.com",
  "phone": "845-990-8909",
  "date": "12/31/2014",
  "time": "19:00 PM",
  "inquiry": "Best chicken parm even made by men :)",
  "notes": "",
  "rating": "Good"
}
]
}

DELETE reputation/deletefeedback

Resource URL

https://api.vbout.com/1/reputation/deletefeedback

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The numerical ID of the review you wish to delete.

Possible Values: (ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/ReputationWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new ReputationWS($user_key);

    $id = '1';
    $results = $app->removeFeedback($id);

    print_r($results);
?>
GET https://api.vbout.com/1/reputation/deletefeedback.json?api_key={YOUR_API_ID}

GET reputation/sentiment

Resource URL

https://api.vbout.com/1/reputation/sentiment

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

filter optional	The type of sentiments returned. Possible Values: all \| positive \| negative \| neutral Default: all
channels optional	The channel from which the sentiments are gathered. Possible Values: all \| yelp \| tripadvisor \| citysearch \| foursquare \| googleplaces \| zagat \| menupage \| opentable Default: all
from optional	The from date which the reviews are returned. The filter must be 'date' for this parameter to work. Possible Values: (Date) Date format accepted: m/d/Y \| Y-m-d Default: (None)
to optional	The to date which the reviews are returned. The filter must be 'date' for this parameter to work. Possible Values: (Date) Date format accepted: m/d/Y \| Y-m-d Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/ReputationWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new ReputationWS($user_key);
    $parms = array(
        'filter' => 'all',
    );

    $results = $app->getSentiments($parms);

    print_r($results);
?>
GET https://api.vbout.com/1/reputation/sentiment.json?filter=positive%2Cnegative&channels=facebook&api_key={YOUR_API_ID}

Example Response

{
"sentiment": {
	"overall": {
	  "stats": {
		"positives": 6,
		"negatives": 2
	  }
	},
	"items": {
	  "Positives": [
		{
		  "inquiry": "Great customer service!",
		  "social": "Facebook",
		  "reviewdate": "03/10/2014"
		},
		{
		  "inquiry": " love the whole experience",
		  "social": "Facebook",
		  "reviewdate": "03/10/2014"
		},
		{
		  "inquiry": " great ",
		  "social": " Facebook ",
		  "reviewdate": "03/10/2014"
		},
		{
		  "inquiry": " delicious site",
		  "social": "Facebook",
		  "reviewdate": "03/10/2014"
		},
		{
		  "inquiry": " love ",
		  "social": "Facebook",
		  "reviewdate": "03/10/2014"
		},
		{
		  "inquiry": " great ",
		  "social": "Facebook",
		  "reviewdate": "03/10/2014"
		}
	  ],
	  "Negatives": [
		{
		  "inquiry": " hate this place",
		  "social": "Facebook",
		  "reviewdate": "03/10/2014"
		},
		{
		  "inquiry": " waiter made us wait for a long time, did not enjoy it",
		  "social": "Facebook",
		  "reviewdate": "03/10/2014"
		}
	  ]
	}
  }
}

GET reputation/stats

Resource URL

https://api.vbout.com/1/reputation/stats

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

filter
optional

The type of stats to return.

Possible Values: all | reviews | socialmedia | feedbackhub
Default: all

from
required

The from date which the reviews are returned. The filter must be 'date' for this parameter to work.

Possible Values: (Date)
Date format accepted: m/d/Y | Y-m-d
Default: (None)

to
required

The to date which the reviews are returned. The filter must be 'date' for this parameter to work.

Possible Values: (Date)
Date format accepted: m/d/Y | Y-m-d
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/ReputationWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new ReputationWS($user_key);
    $parms = array(
        'filter' => 'all',
    );

    $results = $app->getStats($parms);

    print_r($results);
?>
GET https://api.vbout.com/1/reputation/stats.json?channels=all&from=2013-01-01&to=2013-10-01&api_key={YOUR_API_ID}

Example Response

{
"stats": {
	"items": [],
	"Reviews": [
	  {
		"periode": "2013-01-01",
		"good": "0",
		"bad": "0"
	  },
	  {
		"periode": "2013-01-02",
		"good": "5",
		"bad": "2"
	  },
	  {
		"periode": "2013-01-03",
		"good": "9",
		"bad": "1"
	  },
	  ....
	],
"SocialMedia": [
	  {
		"periode": "2013-01-01",
		"twitter": 0,
		"facebook": 1,
		"yelp": 0,
		"foursquare": 0,
		"googleplus": 0,
		"pinterest": 0
	  },
	  {
		"periode": "2013-01-02",
		"twitter": 4,
		"facebook": 0,
		"yelp": 3,
		"foursquare": 0,
		"googleplus": 2,
		"pinterest": 0
	  },
	  {
		"periode": "2013-01-03",
		"twitter": 1,
		"facebook": 0,
		"yelp": 1,
		"foursquare": 4,
		"googleplus": 0,
		"pinterest": 0
	  },
	  {
		"periode": "2013-01-04",
		"twitter": 0,
		"facebook": 1,
		"yelp": 2,
		"foursquare": 4,
		"googleplus": 2,
		"pinterest": 2
	  },
	  ....
	 ],
"FeedbackHub": [
	  {
		"periode": "2013-01-01",
		"views": "4"
	  },
	  {
		"periode": "2013-01-02",
		"views": "1"
	  },
	  {
		"periode": "2013-01-03",
		"views": "8"
	  },
	  {
		"periode": "2013-01-04",
		"views": "11"
	  },
	  {
		"periode": "2013-01-05",
		"views": "2"
	  },
	  {
		"periode": "2013-01-06",
		"views": "12"
	  },
	  {
		"periode": "2013-01-07",
		"views": "20"
	  },
	  {
		"periode": "2013-01-08",
		"views": "24"
	  },
	  {
		"periode": "2013-01-09",
		"views": "0"
	  },
	  {
		"periode": "2013-01-10",
		"views": "19"
	  },
	  {
		"periode": "2013-01-11",
		"views": "0"
	  },
	  {
		"periode": "2013-01-12",
		"views": "10"
	  },
	  ....
	]		  
}
}

GET socialmedia/channels

Resource URL

https://api.vbout.com/1/socialmedia/channels

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

None

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/SocialMediaWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new SocialMediaWS($user_key);
    $results = $app->getChannels();

    print_r($results);
?>
GET https://api.vbout.com/1/socialmedia/channels.json?key={YOUR_API_ID}

Example Response

{
"channels": {
	"Facebook": {
	  "count": 1,
	  "pages": [
		{
		  "id": "510584708978405",
		  "name": "Spotless TV"
		}
	  ]
	},
	"Twitter": {
	  "count": 1,
	  "profiles": [
		{
		  "id": "333248756",
		  "screenname": "imadrajab",
		  "fullname": "Imad Rajab"
		}
	  ]
	},
	"Linkedin": {
	  "count": 0,
	  "profiles": []
	}
  }
}

GET socialmedia/calendar

Resource URL

https://api.vbout.com/1/socialmedia/calendar

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

channels optional	The channels from where the posts are gathered. Possible Values: all \| facebook \| twitter \| linkedin Default: all
from optional	The from date which the reviews are returned. The filter must be 'date' for this parameter to work. Possible Values: (Date) Date format accepted: m/d/Y \| Y-m-d Default: (None)
to optional	The to date which the reviews are returned. The filter must be 'date' for this parameter to work. Possible Values: (Date) Date format accepted: m/d/Y \| Y-m-d Default: (None)
includeposted optional	Include already scheduled posts inside the results. Possible Values: true \| false Default: false
limit optional	Set your record limit number per page. Possible Values: (Number) Default: 10
page optional	Set which page you wanna get. Possible Values: (Number) Default: 1
sort optional	Record Sorting. Possible Values: asc \| desc Default: asc

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/SocialMediaWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new SocialMediaWS($user_key);
    $parms = array(
        'channels' => 'all',
        'includeposted' => 'true',
    );

    $results = $app->getCalendar($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/socialmedia/calendar.json?api_key={YOUR_API_ID}
      channels=all
      includeposted=true

Example Response

{
"calendar": {
	"count": 168,
	"items": {
	  "2013-08-15": {
		"1": {
		  "id": "2347",
		  "message": "http://vbout.com/goto/b0 welcome my man ... how are you [delete url] http://vbout.com/goto/b2",
		  "photo": {
			"thumb": "http://www.kickstarter.com/images/compass/site/facebook_thumb.jpg",
			"original": "http://www.kickstarter.com/images/compass/site/facebook_thumb.jpg"
		  },
		  "channel": {
			"network": "Facebook",
			"type": "Page",
			"id": "510584708978405",
			"name": "Spotless TV",
			"date": "08/15/2013 14:52 PM"
		  }
		},
	   ...
	  },
	  "2013-08-16": {
		"2": {
		  "id": "2366",
		  "message": "test facebook headers",
		  "channel": {
			"network": "Facebook",
			"type": "Page",
			"id": "510584708978405",
			"name": "Spotless TV",
			"date": "08/16/2013 13:39 PM"
		  }
		},
		"3": {
		  "id": "2367",
		  "message": "test facebook post with url  http://vbout.com/goto/bz",
		  "photo": {
			"thumb": "https://www.facebook.com/images/fb_icon_325x325.png",
			"original": "https://www.facebook.com/images/fb_icon_325x325.png"
		  },
		  "channel": {
			"network": "Facebook",
			"type": "Page",
			"id": "510584708978405",
			"name": "Spotless TV",
			"date": "08/16/2013 13:40 PM"
		  }
		},
		"4": {
		  "id": "2368",
		  "message": "test all socials spiders  http://vbout.com/goto/bA",
		  "photo": {
			"thumb": "http://www.domaintools.com/images/logos/dt-logo-gear-50x50.png",
			"original": "http://www.domaintools.com/images/logos/dt-logo-gear-50x50.png"
		  },
		  "channel": {
			"network": "Facebook",
			"type": "Page",
			"id": "510584708978405",
			"name": "Spotless TV",
			"date": "08/16/2013 13:49 PM"
		  }
		},
		...
	  }
	}
  }
}

GET socialmedia/stats

Resource URL

https://api.vbout.com/1/socialmedia/stats

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

channels
optional

The channels where the posts are gathered from.

Possible Values: all | facebook | twitter | linkedin | pinterest
Default: all

sort
optional

Record Sorting.

Possible Values: asc | desc
Default: asc

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/SocialMediaWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new SocialMediaWS($user_key);
    $results = $app->getStats();

    print_r($results);
?>
GET https://api.vbout.com/1/socialmedia/stats.json?channels=facebook&api_key={YOUR_API_ID}

Example Response

{
"stats": {
	"items": [
	  {
		"id": "2236",
		"shortenurl": "A4",
		"realurl": "http://munchies.com/index.php?route=information/contact&__vbtrk=NjkzNDowOnNvY2lhbG1lZGlhOmZhY2Vib29r&__vbtrk=MjgzNTowOnNvY2lhbG1lZGlhOnR3aXR0ZXI=",
		"message": "http://vbout.com/goto/A4 click here",
		"date": "1402401420",
		"tracks": 9,
		"clicks": {
		  "facebook": "9"
		}
	  },
	  {
		"id": "2436",
		"shortenurl": "Di",
		"realurl": "http://www.munchie.com/?__vbtrk=NzkxNjowOnNvY2lhbG1lZGlhOmZhY2Vib29r",
		"message": "Test leadscoring  https://www.vbout.com/goto/Di",
		"date": "1408031400",
		"tracks": 8,
		"clicks": {
		  "facebook": "8"
		}
	  },
	  ...
	]
  }
}

GET socialmedia/getpost

Resource URL

https://api.vbout.com/1/socialmedia/getpost

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The id of the post.

Possible Values: (ID)
Default: (None)

channel
required

The channel where the post is created.

Possible Values: facebook | twitter | linkedin
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/SocialMediaWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new SocialMediaWS($user_key);
    $parms = array(
        'id' => '33',
        'channel' => 'facebook',
    );

    $results = $app->getMyPost($parms);

    print_r($results);
?>
GET https://api.vbout.com/1/socialmedia/getpost.json?id=682&channel=facebook&api_key={YOUR_API_ID}

Example Response

{
"item": {
	"id": "682",
	"title": "OSV Treats & Chews provides a big nutritional boost of phytonutrients & antioxidants from fruits & vegetables; tomatoes, spinach & carrots! http://www.clearconsciencepet.com/osv-meaty-treats/",
	"datetime": "05/16/2013 10:34 AM",
	"item": {
	  "uid": "0"
	},
	"type": "facebook",
	"image": "",
	"profile": "166346373390497"
  }
}

POST socialmedia/addpost

Resource URL

https://api.vbout.com/1/socialmedia/addpost

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

message required	The post message to be scheduled/sent. Possible Values: (Text) Default: (None)
photo optional	The photo which will be attached to the post. Possible Values: (Link) or (Uploaded Image) Default: (None)
channels optional	The channels which the post will be sent to. Possible Values: all \| facebook \| twitter \| linkedin Default: all
isscheduled optional	This flag will make the post to be scheduled for future. Possible Values: true \| false Default: false
scheduleddate optional	Date of the post to be scheduled. Possible Values: (Date) Date format accepted: m/d/Y \| Y-m-d Default: (None)
scheduledhours optional	Time of the post to be scheduled. Possible Values: (Time) Time format accepted: HH:MM Default: (None)
scheduledampm optional	AMPM of the post to be scheduled. Possible Values: AM \| PM \| am \| pm Default: (None)
trackableLinks optional	Convert all links inside message to short urls. Possible Values: true \| false Default: false

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/SocialMediaWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new SocialMediaWS($user_key);
    $parms = array(
        'message' => 'Hello World',
    );

    $results = $app->AddNewpost($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/socialmedia/addpost.json?key={YOUR_API_ID}
      message=Hello World

POST socialmedia/editpost

Resource URL

https://api.vbout.com/1/socialmedia/editpost

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id required	ID of the post message to be edited. Possible Values: (ID) Default: (None)
message optional	The post message to be scheduled/sent. Possible Values: (Text) Default: (None)
photo optional	The photo which will be attached to the post. Possible Values: (Link) or (Uploaded Image) Default: (None)
channels optional	The channels which the post will be sent to. Possible Values: all \| facebook \| twitter \| linkedin Default: all
isscheduled optional	This flag will make the post to be scheduled for future. Possible Values: true \| false Default: false
scheduleddate optional	Date of the post to be scheduled. Possible Values: (Date) Date format accepted: m/d/Y \| Y-m-d Default: (None)
scheduledhours optional	Time of the post to be scheduled. Possible Values: (Time) Time format accepted: HH:MM Default: (None)
scheduledampm optional	AMPM of the post to be scheduled. Possible Values: AM \| PM \| am \| pm Default: (None)
trackableLinks optional	Convert all links inside message to short urls. Possible Values: true \| false Default: false

Example Request

POST https://api.vbout.com/1/socialmedia/editpost.json?key={YOUR_API_ID}
      id=1
      message=Hello World

DELETE socialmedia/deletepost

Resource URL

https://api.vbout.com/1/socialmedia/deletepost

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

ID of the post message to be deleted.

Possible Values: (ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/SocialMediaWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new SocialMediaWS($user_key);

    $id = '1';
    $results = $app->removePost($id);

    print_r($results);
?>
POST https://api.vbout.com/1/socialmedia/deletepost.json?key={YOUR_API_ID}
      id=1

GET emailmarketing/campaigns

Resource URL

https://api.vbout.com/1/emailmarketing/campaigns

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

filter optional	The timeline during which the reviews are returned. Possible Values: all \| sent \| scheduled \| draft \| automation Default: all
from optional	The from date which the reviews are returned. The filter must be 'date' for this parameter to work. Possible Values: (Date) Date format accepted: m/d/Y \| Y-m-d Default: (None)
to optional	The to date which the reviews are returned. The filter must be 'date' for this parameter to work. Possible Values: (Date) Date format accepted: m/d/Y \| Y-m-d Default: (None)
limit optional	Set your record limit number per page. Possible Values: (Number) Default: 10
page optional	Set which page you wanna get. Possible Values: (Number) Default: 1

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);
    $parms = array(
        'filer' => 'all',
        'limit' => '10',
    );

    $results = $app->getCampaigns($parms);

    print_r($results);
?>
GET https://api.vbout.com/1/emailmarketing/campaigns.json?api_key={YOUR_API_ID}

Example Response

{
"campaigns": {
        "count": 1,
        "items": {
          "Draft": {
            "data": [
              {
                "id": "889",
                "subject": "Hop Hop, Happy Fridays have never been happier ",
                "message": "...",
                "replyto": "info@mycompany.com",
                "from_email": "no-reply@mycompany.com",
                "from_name": "Rick's Club American",
                "creation_date": "11/04/2014 16:33"
              }
            ]
          }
		}
	}
}

GET emailmarketing/getcampaign

Resource URL

https://api.vbout.com/1/emailmarketing/getcampaign

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the campaign to return.

Possible Values: (ID)
Default: (None)

type
required

The type of the campaign.

Possible Values: standard | automated
Default: standard

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);
    $parms = array(
        'id' => '35',
    );

    $results = $app->getCampaigns($parms);

    print_r($results);
?>
GET https://api.vbout.com/1/emailmarketing/getcampaign.json?id=889&type=standard&api_key={YOUR_API_ID}

Example Response

{
"item": {
        "id": "889",
        "subject": "Reservations were never that easy!",
        "message": "...",
        "replyto": "no-reply@lofthotels.com",
        "from_email": "reservations@lofthotels.com",
        "from_name": "Loft Hotels",
        "creation_date": "11/04/2014 16:33"
	}
}

GET emailmarketing/stats

Resource URL

https://api.vbout.com/1/emailmarketing/stats

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the campaign to return.

Possible Values: (ID)
Default: (None)

type
required

The type of the campaign.

Possible Values: standard | automated
Default: standard

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);
    $parms = array(
        'id' => '36',
    );

    $results = $app->getStats($parms);

    print_r($results);
?>
GET https://api.vbout.com/1/emailmarketing/stats.json?id=962&type=standard&api_key={YOUR_API_ID}

Example Response

{
"campaign": {
        "stats": {
          "open": "1 (33.33%)",
          "unopened": "2 (66.67%)",
          "bounced": "0 (0%)",
          "unsubscribed": "11 (366.67%)"
        },
        "clicks": [
          {
            "url": "http://www.netalinissim.com/img/logo.jpg?1400686763",
            "message": ""
          },
          {
            "url": "http://www.netalinissim.com",
            "message": "",
            "clickers": [
              "imadrajab@gmail.com(2 clicks)"
            ]
          }
        ]
	}
}

POST emailmarketing/addcampaign

Resource URL

https://api.vbout.com/1/emailmarketing/addcampaign

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

name required	The name of the campaign. Possible Values: (Text) Default: (None)
subject required	The subject line for the campaign. Possible Values: (Text) Default: (None)
fromemail optional	The from email of the campaign. Possible Values: (Email) Default: (None)
from_name optional	The from name of the campaign. Possible Values: (Text) Default: (None)
reply_to optional	The reply to email of the campaign. Possible Values: (Email) Default: (None)
isscheduled optional	The flag to schedule the campaign for the future. Possible Values: true \| false Default: false
isdraft optional	The flag to set the campaign to draft. Possible Values: true \| false Default: false
scheduled_datetime optional	The date and time to schedule the campaign. Possible Values: (Date) Date format accepted: m/d/Y \| Y-m-d Default: (None)
recipients optional	List of campaign recipients. Possible Values: (IDs) Default: (None)
body required	Message body. Possible Values: (Text) Default: (None)
type required	The type of the campaign. Possible Values: standard \| automated Default: standard

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);
    $parms = array(
        'name' => 'Test Campaign',
        'subject' => 'Hello World',
        'fromemail' => 'info@example.com',
        'body' => 'Message body',
        'type' => 'standard',
        'isdraft' => 'true',
    );

    $results = $app->addNewCampaign($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/emailmarketing/addcampaign.json?key={YOUR_API_ID}
      name=Test Campaign
      subject=Hello World
      fromemail=info@example.com
      body=Message body
      type=standard
      isdraft=true

POST emailmarketing/editcampaign

Resource URL

https://api.vbout.com/1/emailmarketing/editcampaign

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id required	The ID of the campaign. Possible Values: (ID) Default: (None)
name required	The name of the campaign. Possible Values: (Text) Default: (None)
subject required	The subject line of the campaign. Possible Values: (Text) Default: (None)
fromemail optional	The from email of the campaign. Possible Values: (Email) Default: (None)
from_name optional	The from name of the campaign. Possible Values: (Text) Default: (None)
reply_to optional	The reply to email of the campaign. Possible Values: (Email) Default: (None)
isscheduled optional	The flag to schedule the campaign for the future. Possible Values: true \| false Default: false
isdraft optional	The flag to set the campaign to draft. Possible Values: true \| false Default: false
scheduled_datetime optional	The date time to schedule the campaign. Date format accepted: m/d/Y \| Y-m-d Default: (None)
recipients optional	List of campaign recipients. Possible Values: (Text) Default: (None)
body required	Message body. Possible Values: (Text) Default: (None)
type required	The type of the campaign. Possible Values: standard \| automated Default: standard

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);
    $parms = array(
        'name' => 'Test Campaign',
        'subject' => 'Hello World',
        'fromemail' => 'info@example.com',
        'body' => 'Here the content of your message',
        'type' => 'standard',
    );

    $results = $app->updateCampaign($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/emailmarketing/editcampaign.json?key={YOUR_API_ID}
      name=Test Campaign
      subject=Hello World
      fromemail=info@example.com
      body=Here the content of your message
      type=standard

DELETE emailmarketing/deletecampaign

Resource URL

https://api.vbout.com/1/emailmarketing/deletecampaign

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the campaign to delete.

Possible Values: (ID)
Default: (None)

type
required

The type of the campaign.

Possible Values: standard | automated
Default: standard

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);
    $parms = array(
        'id' => '886',
        'type' => 'standard',
    );

    $results = $app->removeCampaign($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/emailmarketing/deletecampaign.json?key={YOUR_API_ID}
      id=886
      type=standard

GET emailmarketing/getcontacts

Resource URL

https://api.vbout.com/1/emailmarketing/getcontacts

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

listid
required

The ID of the list to return its contacts.

Possible Values: (IDs)
Default: 0

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);

    $listid = '37';
    $results = $app->getMyContacts($listid);

    print_r($results);
?>
GET https://api.vbout.com/1/emailmarketing/getcontacts.json?listid=524&key={YOUR_API_ID}

Example Response

{
"contacts": {
        "count": 15,
        "items": [
          {
            "id": "3",
            "email": "jim@tester.com",
            "status": "1",
            "registration_date": "11/30/2014 00:00"
          },
          {
            "id": "4",
            "email": "joe@tester.com",
            "status": "1",
            "registration_date": "11/30/2014 00:00"
          },
          {
            "id": "62",
            "email": "jim@tester222.com",
            "status": "1",
            "registration_date": "11/30/2014 00:00"
          },
		  ...
		]
	}
}

GET emailmarketing/getcontactbyemail

Resource URL

https://api.vbout.com/1/emailmarketing/getcontactbyemail

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

email
required

The Email of the contact to return.

Possible Values: (Email)
Default: (None)

listid
optional

The List id of which this contact does belong to.

Possible Values: (ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);

    $email = 'info@example.com';
    $listid = '39';
    $results = $app->searchContact($email, $listid);

    print_r($results);
?>
GET https://api.vbout.com/1/emailmarketing/getcontactbyemail.json?email=info@example.com&key={YOUR_API_ID}

Example Response

{
contact": {
        "id": "3",
        "email": "jim@tester.com",
        "status": "1",
        "registration_date": "11/30/1998 00:00"
      }
}

GET emailmarketing/getcontact

Resource URL

https://api.vbout.com/1/emailmarketing/getcontact

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the contact to return.

Possible Values: (ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);

    $id = '3';
    $results = $app->getMyContact($id);

    print_r($results);
?>
GET https://api.vbout.com/1/emailmarketing/getcontact.json?id=3&key={YOUR_API_ID}

Example Response

{
contact": {
        "id": "3",
        "email": "jim@tester.com",
        "status": "1",
        "registration_date": "11/30/1998 00:00"
      }
}

POST emailmarketing/addcontact

Resource URL

https://api.vbout.com/1/emailmarketing/addcontact

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

email required	The email of the contact. Possible Values: (Email) Default: (None)
status required	The status of the contact. Possible Values: (Active \| Disactive) Default: (None)
listid required	The ID of the list to assign this contact to. Possible Values: (ID) Default: (None)
fields (optional)	The list of custom fields added to a specific list. Possible Values: Array('fieldID'=>'fieldValue') Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);
    $parms = array(
        'email' => 'info@example.com',
        'status' => 'active',
        'listid' => '24,25,12',
        'fields' => array('125' => 'John','1204' => 'Doe','325' => '1983-9-1',),
    );

    $results = $app->addNewContact($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/emailmarketing/addcontact.json?key={YOUR_API_ID}
      email=info@example.com
      status=active
      listid=24,25,12
      fields[125]=John
      fields[1204]=Doe
      fields[325]=1983-9-1

POST emailmarketing/editcontact

Resource URL

https://api.vbout.com/1/emailmarketing/editcontact

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id required	The ID of the contact. Possible Values: (ID) Default: (None)
email required	The email of the contact. Possible Values: (Email) Default: (None)
status required	The status of the contact. Possible Values: (Active \| Disactive) Default: (None)
listid required	The ID of the list to assign this contact to. Possible Values: (ID) Default: (None)
fields (optional)	The list of custom fields added to a specific list. Possible Values: Array('fieldID'=>'fieldValue') Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);
    $parms = array(
        'id' => '1',
        'email' => 'info@example.com',
        'status' => 'active',
        'listid' => '24',
        'fields' => array('125' => 'John','1204' => 'Doe','325' => '1983-9-1',),
    );

    $results = $app->updateContact($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/emailmarketing/editcontact.json?key={YOUR_API_ID}
      id=1
      email=info@example.com
      status=active
      listid=24
      fields[125]=John
      fields[1204]=Doe
      fields[325]=1983-9-1

POST emailmarketing/movecontact

Resource URL

https://api.vbout.com/1/emailmarketing/movecontact

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the contact.

Possible Values: (ID)
Default: (None)

listid
required

The ID of the list to assign this contact to.

Possible Values: (ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);
    $parms = array(
        'id' => '1',
        'listid' => '24',
    );

    $results = $app->moveContact($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/emailmarketing/movecontact.json?key={YOUR_API_ID}
      id=1
      listid=24

DELETE emailmarketing/deletecontact

Resource URL

https://api.vbout.com/1/emailmarketing/deletecontact

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the contact to delete.

Possible Values: (ID)
Default: (None)

listid
required

The ID of the list to delete from.

Possible Values: (ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);

    $id = '14523';
    $listid = '45678';
    $results = $app->removeContact($id, $listid);

    print_r($results);
?>
POST https://api.vbout.com/1/emailmarketing/deletecontact.json?key={YOUR_API_ID}
      id=14523
      listid=45678

GET emailmarketing/getlists

Resource URL

https://api.vbout.com/1/emailmarketing/getlists

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

None

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);
    $results = $app->getMyLists();

    print_r($results);
?>
GET https://api.vbout.com/1/emailmarketing/getlists.json?key={YOUR_API_ID}

Example Response

{ "lists": { "count": 41, "items": [ { "id": "148", "name": "2014 NYC hotel show", "form_title": "2014 NYC hotel show", "email_subject": "", "reply_to": "", "from_email": "", "from_name": "", "confimation_email": "\r\n\r\n\r\n\r\n\r\n

Please click on the link below to confirm your subscription.

[CONFIRMATION_URL]

[BUSINESS_NAME]
[ADDRESS]

\r\n\r\n", "success_email": "\r\n\r\n\r\n\r\n\r\n

Your email is now confirmed! we are excited to have you on our list. We will be in touch soon.

[BUSINESS_NAME]
[ADDRESS]

\r\n\r\n", "confimation_message": "\r\n\r\n\r\n\r\n\r\n

Your signup is almost complete! Please check your email for a confirmation message.

\r\n\r\n", "success_message": "\r\n\r\n\r\n\r\n\r\n

Your subscription is now complete!

\r\n\r\n", "error_message": "\r\n\r\n\r\n\r\n\r\n\r\n\r\n", "doubleOptin": "0", "notify_email": "imadrajab@gmail.com", "creation_date": "04/10/2014 00:00" }, { "id": "157", "name": "Startup Alley NYC", "form_title": "Untitled Form", "email_subject": "", "reply_to": "", "from_email": "", "from_name": "", "confimation_email": "Please click on the link below to confirm your subscription.

[CONFIRMATION_URL]

[BUSINESS_NAME]
[ADDRESS]", "success_email": "Your email is now confirmed! we are excited to have you on our list. We will be in touch soon.

[BUSINESS_NAME]
[ADDRESS]", "confimation_message": "Your signup is almost complete! Please 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": "04/15/2014 00:00" }, { "id": "180", "name": "My Autoresponder List", "form_title": "Untitled Form", "email_subject": "", "reply_to": "", "from_email": "", "from_name": "", "confimation_email": "Please click on the link below to confirm your subscription.

[CONFIRMATION_URL]

[BUSINESS_NAME]
[ADDRESS]", "success_email": "Your email is now confirmed! we are excited to have you on our list. We will be in touch soon.

[BUSINESS_NAME]
[ADDRESS]", "confimation_message": "Your signup is almost complete! Please check your email for a confirmation message.", "success_message": "Your subscription is now complete!", "error_message": "", "doubleOptin": "0", "notify_email": "", "creation_date": "04/22/2014 00:00" }, { "id": "480", "name": "Content Automation Center Funnel", "form_title": "testing automation", "email_subject": "Subscription to testing automation", "reply_to": "no-reply@vbout.com", "from_email": "imadrajab@gmail.com", "from_name": "Vbout", "confimation_email": "\r\n\r\n\r\n\r\n\r\n

Please click on the link below to confirm your subscription.

[CONFIRMATION_URL]

[BUSINESS_NAME]

\r\n\r\n", "success_email": "\r\n\r\n\r\n\r\n\r\n

Your email is now confirmed! we are excited to have you on our list. We will be in touch soon.

[BUSINESS_NAME]

\r\n\r\n", "confimation_message": "\r\n\r\n\r\n\r\n\r\n

Your signup is almost complete! Please check your email for a confirmation message.

\r\n\r\n", "success_message": "\r\n\r\n\r\n\r\n\r\n

Your subscription is now complete!

\r\n\r\n", "error_message": "\r\n\r\n\r\n\r\n\r\n

You have already been subscribed to this list!

\r\n\r\n", "doubleOptin": "0", "notify_email": "imadrajab@gmail.com", "creation_date": "09/29/2014 00:00" }, { "id": "481", "name": "Content Automation Bottom Funnel", "form_title": "testing automation", "email_subject": "", "reply_to": "", "from_email": "", "from_name": "", "confimation_email": "Please click on the link below to confirm your subscription.

[CONFIRMATION_URL]

[BUSINESS_NAME]", "success_email": "Your email is now confirmed! we are excited to have you on our list. We will be in touch soon.

[BUSINESS_NAME]", "confimation_message": "Your signup is almost complete! Please 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": "09/30/2014 00:00" }, { "id": "482", "name": "Birthday List", "form_title": "testing automation", "email_subject": "", "reply_to": "", "from_email": "", "from_name": "", "confimation_email": "\r\n\r\n\r\n\r\n\r\n

Please click on the link below to confirm your subscription.

[CONFIRMATION_URL]

[BUSINESS_NAME]

\r\n\r\n", "success_email": "\r\n\r\n\r\n\r\n\r\n

Your email is now confirmed! we are excited to have you on our list. We will be in touch soon.

[BUSINESS_NAME]

\r\n\r\n", "confimation_message": "\r\n\r\n\r\n\r\n\r\n

Your signup is almost complete! Please check your email for a confirmation message.

\r\n\r\n", "success_message": "\r\n\r\n\r\n\r\n\r\n

Your subscription is now complete!

\r\n\r\n", "error_message": "\r\n\r\n\r\n\r\n\r\n

You have already been subscribed to this list!

\r\n\r\n", "doubleOptin": "0", "notify_email": "", "creation_date": "10/01/2014 00:00" }, { "id": "524", "name": "TestYogaShopFunnelForm", "form_title": "Untitled Form", "email_subject": "", "reply_to": "", "from_email": "", "from_name": "", "confimation_email": "Please click on the link below to confirm your subscription.

[CONFIRMATION_URL]

[BUSINESS_NAME]", "success_email": "Your email is now confirmed! we are excited to have you on our list. We will be in touch soon.

[BUSINESS_NAME]", "confimation_message": "Your signup is almost complete! Please 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" }, ... ] } }

GET emailmarketing/getlist

Resource URL

https://api.vbout.com/1/emailmarketing/getlist

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the list to return.

Possible Values: (ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);

    $id = '524';
    $results = $app->getMyList($id);

    print_r($results);
?>
GET https://api.vbout.com/1/emailmarketing/getlist.json?id=524&key={YOUR_API_ID}

Example Response

{
"list": {
        "id": "524",
        "name": "Landing page subscription form",
        "form_title": "Newsletter Signup",
        "email_subject": "",
        "reply_to": "",
        "from_email": "rich@vbout.com",
        "from_name": "Rich from Vbout",
        "confimation_email": "Please click on the link below to confirm your subscription.

[CONFIRMATION_URL]

[BUSINESS_NAME]",
        "success_email": "Your email is now confirmed! we are excited to have you on our list. We will be in touch soon.

[BUSINESS_NAME]",
        "confimation_message": "Your signup is almost complete! Please 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": {"125":"First Name","1204":"Last Name","325":"Date Of Birth"}
	}
}

POST emailmarketing/addlist

Resource URL

https://api.vbout.com/1/emailmarketing/addlist

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

name required	The name of the list. Possible Values: (Text) Default: (None)
email_subject required	The default subscription subject. Possible Values: (Text) Default: (None)
reply_to required	The Reply to email of the list. Possible Values: (Email) Default: (None)
fromemail required	The From email of the list. Possible Values: (Email) Default: (None)
from_name required	The From name of the list. Possible Values: (Text) Default: (None)
doubleOptin required	Email confirmation required (Double opt-in)? Possible Values: 0 \| 1 Default: (None)
notify required	Notify me of new subscribers. Possible Values: (Text) Default: (None)
notify_email required	Notification Email. Possible Values: (Email) Default: (None)
success_email required	Subscription Success Email. Possible Values: (Email) Default: (None)
success_message required	Subscription Success Message. Possible Values: (Text) Default: (None)
error_message required	Subscription Error Message. Possible Values: (Text) Default: (None)
confirmation_email optional	Confirmation Email Message. Possible Values: (Text) Default: (None)
confirmation_message optional	Confirmation Message. Possible Values: (Text) Default: (None)
communications optional	Turn off Communications? (0-No \| 1-Yes) Possible Values: 0 \| 1 Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);
    $parms = array(
        'name' => 'List 1',
        'email_subject' => 'Hello World',
        'reply_to' => 'no-reply@example.com',
        'fromemail' => 'info@example.com',
        'from_name' => ' Name ',
        'notify' => 'Notify me of new subscribers.',
        'notify_email' => 'info@example.com',
        'success_email' => 'info@example.com',
        'success_message' => 'Subscription Success Message',
        'error_message' => 'Subscription Error Message',
    );

    $results = $app->addNewList($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/emailmarketing/addlist.json?key={YOUR_API_ID}
      name=List 1
      email_subject=Hello World
      reply_to=no-reply@example.com
      fromemail=info@example.com
      from_name= Name 
      notify=Notify me of new subscribers.
      notify_email=info@example.com
      success_email=info@example.com
      success_message=Subscription Success Message
      error_message=Subscription Error Message

POST emailmarketing/editlist

Resource URL

https://api.vbout.com/1/emailmarketing/editlist

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

name required	The name of the list. Possible Values: (Text) Default: (None)
email_subject required	The default subject line of subscription. Possible Values: (Text) Default: (None)
reply_to required	The Reply to email of the list. Possible Values: (Email) Default: (None)
fromemail required	The From email of the list. Possible Values: (Email) Default: (None)
from_name required	The From name of the list. Possible Values: (Text) Default: (None)
doubleOptin required	Email confirmation required (Double opt-in)? Possible Values: 0 \| 1 Default: (None)
notify required	Notify me of new subscribers. Possible Values: (Text) Default: (None)
notify_email required	Notification Email. Possible Values: (Email) Default: (None)
success_email required	Subscription Success Email. Possible Values: (Text) Default: (None)
success_message required	Subscription Success Message. Possible Values: (Text) Default: (None)
error_message required	Subscription Error Message. Possible Values: (Text) Default: (None)
confirmation_email optional	Confirmation Email Message. Possible Values: (Text) Default: (None)
confirmation_message optional	Confirmation Message. Possible Values: (Text) Default: (None)
communications optional	Turn off Communications? (0-No \| 1-Yes) Possible Values: 0 \| 1 Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);
    $parms = array(
        'id' => '1',
        'name' => 'List 1',
        'email_subject' => 'Hello World',
        'reply_to' => 'no-reply@example.com',
        'fromemail' => 'info@example.com',
        'from_name' => ' Name ',
        'notify' => 'Notify me of new subscribers.',
        'notify_email' => 'info@example.com',
        'success_email' => 'info@example.com',
        'success_message' => 'Subscription Success Message',
        'error_message' => 'Subscription Error Message',
    );

    $results = $app->updateList($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/emailmarketing/editlist.json?key={YOUR_API_ID}
      id=1
      name=List 1
      email_subject=Hello World
      reply_to=no-reply@example.com
      fromemail=info@example.com
      from_name= Name 
      notify=Notify me of new subscribers.
      notify_email=info@example.com
      success_email=info@example.com
      success_message=Subscription Success Message
      error_message=Subscription Error Message

DELETE emailmarketing/deletelist

Resource URL

https://api.vbout.com/1/emailmarketing/deletelist

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the list to delete.

Possible Values: (ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/EmailMarketingWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new EmailMarketingWS($user_key);

    $id = '320';
    $results = $app->removeList($id);

    print_r($results);
?>
POST https://api.vbout.com/1/emailmarketing/deletelist.json?key={YOUR_API_ID}
      id=320

GET user/lists

Resource URL

https://api.vbout.com/1/user/lists

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

businessid
optional

The ID of the business if it's an agency to return its contacts.

Possible Values: (ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/UserWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new UserWS($user_key);
    $results = $app->getusers();

    print_r($results);
?>
GET https://api.vbout.com/1/user/lists.json?businessid=124&key={YOUR_API_ID}

Example Response

{
"users": {
        "count": 2,
        "items": {
          "34": {
            "users": {
              "34": {
                "fullname": "Imad Rajab",
                "username": "imadrajab@yopmail.com"
              },
              ...
            }
          },
          "193": {
            "users": {
              "45": {
                "fullname": "Test",
                "username": "test22@yopmail.com",
                "group": "-",
                "status": "Active"
              },
              ...
            }
          }
        }
      }
}

GET user/managers

Resource URL

https://api.vbout.com/1/user/managers

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

None

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/UserWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new UserWS($user_key);
    $results = $app->getManagers();

    print_r($results);
?>
GET https://api.vbout.com/1/user/managers.json?key={YOUR_API_ID}

Example Response

{
 "users": {
        "count": 7,
        "items": [
          {
            "id": "2",
            "fullname": "Imad Rajab",
            "email": "imadmasteruser@yopmail.com",
            "status": "Active"
          },
          {
            "id": "10",
            "fullname": "Johnny Moubayed",
            "email": "johnnymoubayed@yopmail.com",
            "status": "Active"
          },
		  ...
}
}

POST user/status

Resource URL

https://api.vbout.com/1/user/status

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the user to change status.

Possible Values: (ID)
Default: (None)

type
required

The type of the user.

Possible Values: user | manager
Default: user

status
required

The status of the user.

Possible Values: 0 [DISABLE] | 1 [ENABLE]
Default: 1

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/UserWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new UserWS($user_key);
    $parms = array(
        'id' => '1',
        'type' => 'user',
        'status' => '0',
    );

    $results = $app->changeStatus($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/user/status.json?key={YOUR_API_ID}
      id=1
      type=user
      status=0

POST user/add

Resource URL

https://api.vbout.com/1/user/add

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

fullname required	The name of the user. Possible Values: (Text) Default: (None)
username required	The username of the user. Possible Values: (Text) Default: (None)
password required	The password of the user. Possible Values: (Text) Default: (None)
type required	The type of the user. Possible Values: user \| manager Default: user
group optional	The group id of the user. Possible Values: (ID) Default: 0
permissions optional	The permissions of the user. (comma-separated values) Possible Values: reputation_center \| foursquare \| pinterest \| social_media \| email_marketing \| master_reporting \| users_and_workflow \| smart_calendar \| site_builder \| asset_manager \| task_manager \| notes \| social_tracker \| collaboration \| google_analytics \| email_automation_workflow \| live_hashtags \| goal_conversion_tracking \| expedia_affiliate_network \| behavioral_webhooks \| lead_scoring \| user_groups Default: NULL

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/UserWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new UserWS($user_key);
    $parms = array(
        'fullname' => 'John Smith',
        'username' => 'john@example.com',
        'password' => 'user123',
        'type' => 'user',
    );

    $results = $app->addNewUser($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/user/add.json?key={YOUR_API_ID}
      fullname=John Smith
      username=john@example.com
      password=user123
      type=user

POST user/edit

Resource URL

https://api.vbout.com/1/user/edit

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id required	The ID of the user. Possible Values: (ID) Default: (None)
fullname required	The name of the user. Possible Values: (Text) Default: (None)
username required	The username of the user. Possible Values: (Text) Default: (None)
password required	The password of the user. Possible Values: (Text) Default: (None)
type required	The type of the user. Possible Values: user \| manager Default: user
group optional	The group id of the user. Possible Values: (ID) Default: 0
permissions optional	The permissions of the user. (comma-separated values) Possible Values: reputation_center \| foursquare \| pinterest \| social_media \| email_marketing \| master_reporting \| users_and_workflow \| smart_calendar \| site_builder \| asset_manager \| task_manager \| notes \| social_tracker \| collaboration \| google_analytics \| email_automation_workflow \| live_hashtags \| goal_conversion_tracking \| expedia_affiliate_network \| behavioral_webhooks \| lead_scoring \| user_groups Default: NULL

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/UserWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new UserWS($user_key);
    $parms = array(
        'fullname' => 'John Smith',
        'username' => 'john@example.com',
        'password' => 'user123',
        'type' => 'user',
    );

    $results = $app->updateUser($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/user/edit.json?key={YOUR_API_ID}
      fullname=John Smith
      username=john@example.com
      password=user123
      type=user

DELETE user/delete

Resource URL

https://api.vbout.com/1/user/delete

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the user to delete.

Possible Values: (ID)
Default: (None)

type
required

The type of the user.

Possible Values: user | manager
Default: user

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/UserWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new UserWS($user_key);
    $parms = array(
        'id' => '1',
        'type' => 'user',
    );

    $results = $app->removeUser($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/user/delete.json?key={YOUR_API_ID}
      id=1
      type=user

GET user/groups

Resource URL

https://api.vbout.com/1/user/groups

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

None

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/UserWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new UserWS($user_key);
    $results = $app->getGroups();

    print_r($results);
?>
GET https://api.vbout.com/1/user/groups.json?key={YOUR_API_ID}

Example Response

{
 "groups": {
        "count": 3,
        "items": [
          {
            "id": "4",
            "name": "Sales Team #Chicago",
            "status": "Active"
          },
          {
            "id": "5",
            "name": "Sales Team #New York",
            "status": "Active"
          },
		  ...
}
}

DELETE user/groupdelete

Resource URL

https://api.vbout.com/1/user/groupdelete

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the group to delete.

Possible Values: (ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/UserWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new UserWS($user_key);
    $parms = array(
        'id' => '1',
    );

    $results = $app->removeGroup($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/user/groupdelete.json?key={YOUR_API_ID}
      id=1

POST user/groupstatus

Resource URL

https://api.vbout.com/1/user/groupstatus

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the group to change status.

Possible Values: (ID)
Default: (None)

status
required

The status of the group.

Possible Values: 0 [DISABLE] | 1 [ENABLE]
Default: 1

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/UserWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new UserWS($user_key);
    $parms = array(
        'id' => '1',
        'status' => '0',
    );

    $results = $app->changeGroupStatus($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/user/groupstatus.json?key={YOUR_API_ID}
      id=1
      status=0

GET goal/lists

Resource URL

https://api.vbout.com/1/goal/lists

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

None

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/GoalWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new GoalWS($user_key);
    $results = $app->getGoals();

    print_r($results);
?>
GET https://api.vbout.com/1/goal/lists.json?key={YOUR_API_ID}

Example Response

{
"goals": {
        "count": 8,
        "items": [
          {
            "id": "41",
            "name": "Cart conversion (All Links)",
            "goal_value": {
              "type": "Fixed",
              "value": "80.0000"
            },
            "type": "Event Triggered",
            "event_type": "Link(s) Clicked",
            "event_link_rule": "All of these link(s) clicked",
            "links": [
                "http://yogashop.com/index.php?route=information/contact",
                "http://yogashop.com/index.php?route=blog/blog"
        ],
            ],
            "has_action": "Yes",
            "action": {
              "id": "69",
              "name": "Action is deleted!"
            }
          },
              ...
      }
}

GET goal/listbydomain

Resource URL

https://api.vbout.com/1/goal/listbydomain

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

domainid
required

The ID of the domain to return its goals.

Possible Values: (ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/GoalWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new GoalWS($user_key);
    $parms = array(
        'domainid' => '41',
    );

    $results = $app->getGoalsByDomain($parms);

    print_r($results);
?>
GET https://api.vbout.com/1/goal/listbydomain.json?domainid=1&key={YOUR_API_ID}

Example Response

{
"goals": {
        "count": 7,
        "items": [
          {
            "id": "41",
            "name": "Test Goal Action (All Links)",
            "goal_value": {
              "type": "Fixed",
              "value": "0.0000"
            },
            "type": "Event Triggered",
            "event_type": "Link(s) Clicked",
            "event_link_rule": "All of these link(s) clicked",
            "links": [
              "http://yogashop.com/index.php?route=information/contact",
              "http://yogashop.com/index.php?route=blog/blog"
        ],
            "has_action": "Yes",
            "action": {
              "id": "69",
              "name": "Action is deleted!"
            }
          },
              ...
      }
}

GET goal/show

Resource URL

https://api.vbout.com/1/goal/show

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the goal.

Possible Values: (ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/GoalWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new GoalWS($user_key);
    $parms = array(
        'id' => '46',
    );

    $results = $app->getGoal($parms);

    print_r($results);
?>
GET https://api.vbout.com/1/goal/show.json?id=41&key={YOUR_API_ID}

Example Response

{
"goal": {
        "id": "41",
        "name": "Test Goal Action (All Links)",
        "goal_value": {
          "type": "Fixed",
          "value": "0.0000"
        },
        "type": "Event Triggered",
        "event_type": "Link(s) Clicked",
        "event_link_rule": "All of these link(s) clicked",
        "links": [
          "http://yogashop.com/index.php?route=information/contact",
          "http://yogashop.com/index.php?route=blog/blog"
        ],
        "has_action": "Yes",
        "action": {
          "id": "69",
          "name": "Action is deleted!"
        }
      }
}

POST goal/add

Resource URL

https://api.vbout.com/1/goal/add

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

domainid required	The Domain id of the goal. Possible Values: (ID) Default: (None)
name required	The name of the goal. Possible Values: (Text) Default: (None)
type required	The type of the goal. Possible Values: url \| duration \| pages \| ppc \| event Default: url
value_type optional	Goal Value Type. Possible Values: fixed \| variable Default: fixed
value optional	Goal Value if the value type is fixed. Possible Values: (Number) Default: 0
destination_url optional	The Destination URL. Possible Values: (Link) Default: (None)
duration_hours optional	The Duration Number of Hours. Possible Values: (Number) Default: 0
duration_minutes optional	The Duration Number of Minutes. Possible Values: (Number) Default: 0
duration_seconds optional	The Duration Number of Seconds. Possible Values: (Number) Default: 0
pages optional	The Number of Pages. Possible Values: (Number) Default: 0
ppc_networks optional	The type of Referral Networks. Possible Values: google \| bing \| facebook \| twitter \| linkedin Default: None
event_type optional	The type of Event. Possible Values: links \| videos \| form Default: None
goal_event_filter optional	Goal will be met if. Possible Values: any \| all \| all Default: any
event_links optional	The Event Links. Possible Values: (Link) Default: (None)
event_videos optional	links of embedded video. Possible Values: (Links) Default: (None) Allow Multiple: Yes
form_identity_type optional	Form catch by Possible Values: id \| name Default: id
form_identity optional	The Form identity. Possible Values: (Text) Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/GoalWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new GoalWS($user_key);
    $parms = array(
        'domainid' => '1',
        'name' => 'goal Name',
        'type' => 'url',
    );

    $results = $app->addNewGoal($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/goal/add.json?key={YOUR_API_ID}
      domainid=1
      name=goal Name
      type=url

POST goal/edit

Resource URL

https://api.vbout.com/1/goal/edit

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id required	The ID of the goal. Possible Values: (ID) Default: (None)
name required	The name of the goal. Possible Values: (Text) Default: (None)
type required	The type of the goal. Possible Values: url \| duration \| pages \| ppc \| event Default: url
value_type optional	Goal Value Type. Possible Values: fixed \| variable Default: fixed
value optional	Goal Value if the value type is fixed. Possible Values: (Number) Default: 0
destination_url optional	The Destination URL. Possible Values: (Link) Default: (None)
duration_hours optional	The Duration Number of Hours. Possible Values: (Number) Default: 0
duration_minutes optional	The Duration Number of Minutes. Possible Values: (Number) Default: 0
duration_seconds optional	The Duration Number of Seconds. Possible Values: (Number) Default: 0
pages optional	The Number of Pages. Possible Values: (Number) Default: 0
ppc_networks optional	The type of Referral Networks. Possible Values: google \| bing \| facebook \| twitter \| linkedin Default: None
event_type optional	The type of Event. Possible Values: links \| videos \| form Default: None
goal_event_filter optional	Goal will be met if. Possible Values: any \| all \| all Default: any
event_links optional	The Event Links. Possible Values: (Link) Default: (None)
event_videos optional	links of embedded video. Possible Values: (Links) Default: (None) Allow Multiple: Yes
form_identity_type optional	Form catch by Possible Values: id \| name Default: id
form_identity optional	The Form identity. Possible Values: (Text) Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/GoalWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new GoalWS($user_key);
    $parms = array(
        'id' => '1',
        'name' => 'goal Name',
        'type' => 'url',
    );

    $results = $app->updateGoal($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/goal/edit.json?key={YOUR_API_ID}
      id=1
      name=goal Name
      type=url

DELETE goal/delete

Resource URL

https://api.vbout.com/1/goal/delete

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the goal to delete.

Possible Values: (ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/GoalWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new GoalWS($user_key);
    $parms = array(
        'id' => '1',
    );

    $results = $app->removeGoal($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/goal/delete.json?key={YOUR_API_ID}
      id=1

GET webhook/lists

Resource URL

https://api.vbout.com/1/webhook/lists

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

None

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/WebhookWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new WebhookWS($user_key);
    $results = $app->getWebhooks();

    print_r($results);
?>
GET https://api.vbout.com/1/webhook/lists.json?key={YOUR_API_ID}

Example Response

{
"webhooks": {
        "count": 1,
        "items": [
          {
           "id": "107",
            "name": "Doctor Request Poll!",
            "type": "On Page Exit",
            "domain_id": "1",
            "url": {
              "filter": "Matches Exactly",
              "link": ""
            },
            "action_type": "HTML Message",
            "action_rules": {
              "execute_for": "All Visitors",
              "device_filter": "All Devices",
              "interval": "Repeats",
              "delay": {
                "hours": "0",
                "minutes": "0",
                "seconds": "0"
              }
            },
            "action_stype": "Popup"
          },
              ...
      }
}

GET webhook/show

Resource URL

https://api.vbout.com/1/webhook/show

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the webhook.

Possible Values: (ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/WebhookWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new WebhookWS($user_key);
    $results = $app->getWebhook();

    print_r($results);
?>
GET https://api.vbout.com/1/webhook/show.json?id=107&key={YOUR_API_ID}

Example Response

{
"webhook": {
        "id": "107",
		"name": "Poll on who will be elected!",
		"type": "On Page Exit",
		"domain_id": "1",
		"url": {
		  "filter": "Matches Exactly",
		  "link": ""
		},
		"action_type": "HTML Message",
		"action_rules": {
		  "execute_for": "All Visitors",
		  "device_filter": "All Devices",
		  "interval": "Repeats",
		  "delay": {
			"hours": "0",
			"minutes": "0",
			"seconds": "0"
		  }
		},
		"action_stype": "Popup"
      }
}

POST webhook/add

Resource URL

https://api.vbout.com/1/webhook/add

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

domainid required	The Domain id of the webhook. Possible Values: (ID) Default: (None)
name required	The name of the webhook. Possible Values: (Text) Default: (None)
type required	The type of the webhook. Possible Values: page_exit \| page_entry \| goal_trigger Default: page_exit
action_url optional	Page Url. Possible Values: (Text) Default: (None)
action_type required	The type of the action. Possible Values: html_msg \| form \| poll \| redirection \| trigger_js Default: html_msg
redirection_url optional	Redirection URL. Possible Values: (Link) Default: (None)
list_id optional	The List ID. Possible Values: (ID) Default: (None)
poll_question optional	The Polling Question. Possible Values: (Text) Default: (None)
poll_choices optional	The polling Choices. Possible Values: (Text) Default: (None) Allow Multiple: Yes
js_code optional	The Javascript Code. Possible Values: (Text) Default: (None)
action_startdate optional	The Action Trigger Start Date. Possible Values: (Date) Default: (None)
action_enddate optional	The Action Trigger End Date. Possible Values: (Date) Default: (None)
action_targetusers optional	The Target Users. Possible Values: all \| subscribers \| anonymous Default: all
action_devicefilter optional	The Device Filter. Possible Values: all \| desktop \| mobile Default: all
action_ppcfilter optional	The PPC Referral Network Filter. Possible Values: google \| bing \| facebook \| twitter \| linkedin Default: None
action_geofilter optional	The Geo-Location Filter. Possible Values: (Text) Default: (None) Allow Multiple: Yes
action_frequency optional	The Action Frequency. Possible Values: repeat \| one_time Default: repeat
delay_hours optional	The Delay Number of Hours. Possible Values: (Number) Default: 0
delay_minutes optional	The Delay Number of Minutes. Possible Values: (Number) Default: 0
delay_seconds optional	The Delay Number of Seconds. Possible Values: (Number) Default: 0
action_style optional	Choose Action Style. Possible Values: popup \| sticky_bar Default: popup
action_text optional	Action Text. Possible Values: (Text) Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/WebhookWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new WebhookWS($user_key);
    $parms = array(
        'id' => '1',
        'name' => 'webhook Name',
        'action_type' => 'page_exit',
    );

    $results = $app->addNewWebhook($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/webhook/add.json?key={YOUR_API_ID}
      id=1
      name=webhook Name
      action_type=page_exit

POST webhook/edit

Resource URL

https://api.vbout.com/1/webhook/edit

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id required	The ID of the webhook. Possible Values: (ID) Default: (None)
name required	The name of the webhook. Possible Values: (Text) Default: (None)
type required	The type of the webhook. Possible Values: page_exit \| page_entry \| goal_trigger Default: page_exit
action_url optional	Page Url. Possible Values: (Link) Default: (None)
action_type required	The type of the action. Possible Values: html_msg \| form \| poll \| redirection \| trigger_js Default: html_msg
redirection_url optional	Redirection URL. Possible Values: (Link) Default: (None)
list_id optional	The List ID. Possible Values: (ID) Default: (None)
poll_question optional	The Polling Question. Possible Values: (Text) Default: (None)
poll_choices optional	The polling Choices. Possible Values: (Text) Default: (None) Allow Multiple: Yes
js_code optional	The Javascript Code. Possible Values: (Text) Default: (None)
action_startdate optional	The Action Trigger Start Date. Possible Values: (Date) Default: (None)
action_enddate optional	The Action Trigger End Date. Possible Values: (Date) Default: (None)
action_targetusers optional	The Target Users. Possible Values: all \| subscribers \| anonymous Default: all
action_devicefilter optional	The Device Filter. Possible Values: all \| desktop \| mobile Default: all
action_ppcfilter optional	The PPC Referral Network Filter. Possible Values: google \| bing \| facebook \| twitter \| linkedin Default: None
action_geofilter optional	The Geo-Location Filter. Possible Values: (Text) Default: (None) Allow Multiple: Yes
action_frequency optional	The Action Frequency. Possible Values: repeat \| one_time Default: repeat
delay_hours optional	The Delay Number of Hours. Possible Values: (Number) Default: 0
delay_minutes optional	The Delay Number of Minutes. Possible Values: (Number) Default: 0
delay_seconds optional	The Delay Number of Seconds. Possible Values: (Number) Default: 0
action_style optional	Choose Action Style. Possible Values: popup \| sticky_bar Default: popup
action_text optional	Action Text. Possible Values: (Text) Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/WebhookWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new WebhookWS($user_key);
    $parms = array(
        'id' => '1',
        'name' => 'webhook Name',
        'action_type' => 'page_exit',
    );

    $results = $app->updateWebhook($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/webhook/edit.json?key={YOUR_API_ID}
      id=1
      name=webhook Name
      action_type=page_exit

DELETE webhook/delete

Resource URL

https://api.vbout.com/1/webhook/delete

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The ID of the webhook to delete.

Possible Values: (ID)
Default: (None)

Example Request

cUrl | PHP
<PHP
    require_once('../PATH/TO/services/WebhookWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new WebhookWS($user_key);
    $parms = array(
        'id' => '1',
    );

    $results = $app->removeWebhook($parms);

    print_r($results);
?>
POST https://api.vbout.com/1/webhook/delete.json?key={YOUR_API_ID}
      id=1

API Documentation v1.0

Application Services

GET app/me

Resource URL

Resource Information

Parameters

Example Request

Example Response

Reputation Services

GET reputation/direct

Resource URL

Resource Information

Parameters

Example Request

Example Response

GET reputation/online

Resource URL

Resource Information

Parameters

Example Request

Example Response

GET reputation/getfeedback

Resource URL

Resource Information

Parameters

Example Request

Example Response

DELETE reputation/deletefeedback

Resource URL

Resource Information

Parameters

Example Request

GET reputation/sentiment

Resource URL

Resource Information

Parameters

Example Request

Example Response

GET reputation/stats

Resource URL

Resource Information

Parameters

Example Request

Example Response

Social Media Services

GET socialmedia/channels

Resource URL

Resource Information

Parameters

Example Request

Example Response

GET socialmedia/calendar

Resource URL

Resource Information

Parameters

Example Request

Example Response

GET socialmedia/stats

Resource URL

Resource Information

Parameters

Example Request

Example Response

GET socialmedia/getpost

Resource URL

Resource Information

Parameters

Example Request

Example Response

POST socialmedia/addpost

Resource URL

Resource Information

Parameters

Example Request

POST socialmedia/editpost

Resource URL

Resource Information

Parameters

Example Request

DELETE socialmedia/deletepost