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);
    $params = array(
        'filter' => 'today',
    );

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

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

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);
    $params = array(
        'channels' => 'all',
    );

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

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

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?key={YOUR_API_ID}&id=163

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?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);
    $params = array(
        'filter' => 'all',
    );

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

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

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);
    $params = array(
        'filter' => 'all',
    );

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

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

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);
    $params = array(
        'channels' => 'all',
        'includeposted' => 'true',
    );

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

    print_r($results);
?>
POST https://api.vbout.com/1/socialmedia/calendar.json?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);
    $params = array(
        'channels' => 'facebook',
    );

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

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

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);
    $params = array(
        'id' => '682',
        'channel' => 'facebook',
    );

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

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

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);
    $params = array(
        'message' => 'Hello World',
    );

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

    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);
    $params = array(
        'filter' => 'all',
        'limit' => '10',
    );

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

    print_r($results);
?>
GET https://api.vbout.com/1/emailmarketing/campaigns.json?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);
    $params = array(
        'id' => '889',
        'type' => 'standard',
    );

    $results = $app->getCampaign( $params );

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

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);
    $params = array(
        'id' => '962',
        'type' => 'standard',
    );

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

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

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)
audiences optional	IDs of audience campaign recipients.(comma separated) Possible Values: (IDs) Default: (None)
lists optional	IDs of list campaign recipients.(comma separated) 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);
    $params = array(
        'name' => 'Test Campaign',
        'subject' => 'Hello World',
        'fromemail' => 'info@example.com',
        'body' => 'Message body',
        'type' => 'standard',
        'isdraft' => 'true',
    );

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

    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)
audiences optional	IDs of audience campaign recipients.(comma separated) Possible Values: (IDs) Default: (None)
lists optional	IDs of list campaign recipients.(comma separated) 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);
    $params = array(
        'name' => 'Test Campaign',
        'subject' => 'Hello World',
        'fromemail' => 'info@example.com',
        'body' => 'Here the content of your message',
        'type' => 'standard',
    );

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

    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);
    $params = array(
        'id' => '886',
        'type' => 'standard',
    );

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

    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 = '524';
    $results = $app->getMyContacts($listid);

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

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?key={YOUR_API_ID}&email=info@example.com&listid=39

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?key={YOUR_API_ID}&id=3

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)
ipaddress (optional)	The ip of the contact. Possible Values: (IP) 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);
    $params = array(
        'email' => 'info@example.com',
        'status' => 'active',
        'listid' => '24,25,12',
        'fields' => array('125' => 'John','1204' => 'Doe','325' => '1983-9-1',),
    );

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

    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 (optional)	The email of the contact. Possible Values: (Email) Default: (None)
ipaddress (optional)	The ip of the contact. Possible Values: (IP) Default: (None)
status (optional)	The status of the contact. Possible Values: (Active \| Disactive) 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);
    $params = array(
        'id' => '1',
        'email' => 'info@example.com',
        'status' => 'active',
        'listid' => '24',
        'fields' => array('125' => 'John','1204' => 'Doe','325' => '1983-9-1',),
    );

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

    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/synccontact

Resource URL

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

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes
Note	All emails having the same email text available in the provided list will be updated if exists (case email is not required).

Parameters

email required	The email of the contact. Possible Values: (Email) Default: (None)
ipaddress (optional)	The ip of the contact. Possible Values: (IP) 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);
    $params = array(
        'email' => 'info@example.com',
        'status' => 'active',
        'listid' => '24,25,12',
        'fields' => array('125' => 'John','1204' => 'Doe','325' => '1983-9-1',),
    );

    $results = $app->syncContactMethod( $params );

    print_r($results);
?>
POST https://api.vbout.com/1/emailmarketing/synccontact.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/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);
    $params = array(
        'id' => '1',
        'listid' => '24',
    );

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

    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?key={YOUR_API_ID}&id=524

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);
    $params = 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( $params );

    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);
    $params = 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( $params );

    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 emailmarketing/getaudiences

Resource URL

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

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->getMyAudiences();

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

Example Response

{
"audiences": {
        "count": 41,
        "items": [
          {
            "id": "148",
            "name": "2014 NYC hotel show",
          },
          {
            "id": "157",
            "name": "Startup Alley NYC",
          },
          {
            "id": "180",
            "name": "My Autoresponder Audience",
          },
          {
            "id": "480",
            "name": "Content Automation Center Funnel",
          },
          {
            "id": "481",
            "name": "Content Automation Bottom Funnel",
          },
          {
            "id": "482",
            "name": "Birthday Audience",
          },
          {
            "id": "524",
            "name": "TestYogaShopFunnelForm",
          },
          ...
        ]
	}
}

POST emailmarketing/addactivity

Resource URL

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

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

id
required

The id of the contact.

Possible Values: (ID)
Default: (None)

description
required

The description of the activity.

Possible Values: (Text)
Default: (None)

datetime
required

The date and time to activity.

Possible Values: (DateTime)
Date format accepted: Y-m-d h:m
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);
    $params = array(
        'id' => 'xxxxx',
        'description' => 'this is my first activity',
        'datetime' => '2021-10-28 13:19',
    );

    $results = $app->addNewActivity( $params );

    print_r($results);
?>
POST https://api.vbout.com/1/emailmarketing/addactivity.json?key={YOUR_API_ID}
      id=xxxxx
      description=this is my first activity
      datetime=2021-10-28 13:19

POST emailmarketing/addtag

Resource URL

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

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes
Note	List of tags can be sent as a batch, separated by a comma. Either email or id can be used

Parameters

id

The id of the contact.

Possible Values: (ID)
Default: (None)

email

The email of the contact.

Possible Values: (text)
Default: (None)

tagname
required

Tag(s) to be added.

Possible Values: (Text)
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);
    $params = array(
        'id' => 'xxxxx',
        'tagname' => 'this is my first tag',
    );

    $results = $app->addTag( $params );

    print_r($results);
?>
POST https://api.vbout.com/1/emailmarketing/addtag.json?key={YOUR_API_ID}
      id=xxxxx
      tagname=this is my first tag

POST emailmarketing/removetag

Resource URL

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

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes
Note	List of tags can be sent as a batch, separated by a comma. Either email or id can be used

Parameters

id
required

The id of the contact.

Possible Values: (ID)
Default: (None)

email

The email of the contact.

Possible Values: (text)
Default: (None)

tagname
required

Tag(s) to be added.

Possible Values: (Text)
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);
    $params = array(
        'id' => 'xxxxx',
        'tagname' => 'this is my first tag',
    );

    $results = $app->deleteTag( $params );

    print_r($results);
?>
POST https://api.vbout.com/1/emailmarketing/removetag.json?key={YOUR_API_ID}
      id=xxxxx
      tagname=this is my first tag

GET emailmarketing/getcoupon

Resource URL

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

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

email
required

The email of the contact to return coupons of.

Possible Values: (EMAIL)
Default: john@doe.com

campaignid
required

The ID of the campaign containing coupons.

Possible Values: (CAMPAIGN ID)
Default: 1254

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 = 'john@doe.com';
    $results = $app->getCoupon($email);

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

Example Response

{
"coupons": [
                {
                    "id": "15817148",
                    "email": "john@doe.com",
                    "couponcode": "XXXXXXXXXXXXXX",
                    "couponredeemed": "0",
                    "couponredeemedon": "N/A"
                }
        ]
}

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);
    $params = array(
        'businessid' => '124',
    );

    $results = $app->getusers( $params );

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

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);
    $params = array(
        'id' => '1',
        'type' => 'user',
        'status' => '0',
    );

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

    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);
    $params = array(
        'fullname' => 'John Smith',
        'username' => 'john@example.com',
        'password' => 'user123',
        'type' => 'user',
    );

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

    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);
    $params = array(
        'fullname' => 'John Smith',
        'username' => 'john@example.com',
        'password' => 'user123',
        'type' => 'user',
    );

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

    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);
    $params = array(
        'id' => '1',
        'type' => 'user',
    );

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

    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);
    $params = array(
        'id' => '1',
    );

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

    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);
    $params = array(
        'id' => '1',
        'status' => '0',
    );

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

    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);
    $params = array(
        'domainid' => '41',
    );

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

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

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);
    $params = array(
        'id' => '46',
    );

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

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

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);
    $params = array(
        'domainid' => '1',
        'name' => 'goal Name',
        'type' => 'url',
    );

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

    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);
    $params = array(
        'id' => '1',
        'name' => 'goal Name',
        'type' => 'url',
    );

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

    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);
    $params = array(
        'id' => '1',
    );

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

    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);
    $params = array(
        'id' => '107',
    );

    $results = $app->getWebhook( $params );

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

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);
    $params = array(
        'id' => '1',
        'name' => 'webhook Name',
        'action_type' => 'page_exit',
    );

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

    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);
    $params = array(
        'id' => '1',
        'name' => 'webhook Name',
        'action_type' => 'page_exit',
    );

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

    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);
    $params = array(
        'id' => '1',
    );

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

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

POST register/createaccount

Resource URL

https://api.vbout.com/1/register/createaccount

Resource Information

Response formats	JSON/XML
Requires authentication?	Yes

Parameters

contact_name required	The contact name. Possible Values: (Text) Default: (None)
business_name required	The business name. Possible Values: (Text) Default: (None)
business_email required	The business email. Possible Values: (Email) Default: (None)
business_phone required	The business phone. Possible Values: (Text) Default: (None)
business_vbout_name (optional)	The business VBOUT name. Possible Values: (Text) Default: (None)
business_password (optional)	The business password. Possible Values: (Text) Default: (None)
business_vat_number (optional)	The business VAT number. Possible Values: (Text) Default: (None)
timezone (optional)	The business timezone. Possible Values: https://www.php.net/manual/en/timezones.php Default: (America/New_York)
plan_id required	The custom plan id. Possible Values: (Number) Default: (None)
commission_structure (optional)	The commission structure. Possible Values: (1: Discount to paid amount) \| (2: Normal commission payout) Default: 1
disable_billing_access (optional)	Disable Billing Access. Possible Values: 0 \| 1 Default: 0
disable_settings_access (optional)	Disable Settings Access. Possible Values: 0 \| 1 Default: 0
pay_on_signup (optional)	Pay using agency saved card on success signup, and save the card to the newly created account. Possible Values: 0 \| 1 Default: 0

Example Request

cUrl | PHP
<?php

    require_once('../PATH/TO/services/RegisterWS.php');
	
    $user_key = array('api_key' => '{YOUR_API_KEY}');
	
    $app = new RegisterWS($user_key);
    $params = array(
        'contact_name' => 'VBOUT TEST',
        'business_name' => 'VBOUT TEST',
        'business_email' => 'info@vobut.com',
        'business_phone' => '123456789',
        'business_vbout_name' => 'VBOUT TEST',
        'business_password' => 'xxxxxxxxxxx',
        'business_vat_number' => '123',
        'timezone' => 'America/Los_Angeles',
        'plan_id' => '10',
        'commission_structure' => '1',
        'disable_billing_access' => '0',
        'disable_settings_access' => '1',
        'pay_on_signup' => '1',
    );

    $results = $app->createAccount( $params );

    print_r($results);
?>
POST https://api.vbout.com/1/register/createaccount.json?key={YOUR_API_ID}
      contact_name=VBOUT TEST
      business_name=VBOUT TEST
      business_email=info@vobut.com
      business_phone=123456789
      business_vbout_name=VBOUT TEST
      business_password=xxxxxxxxxxx
      business_vat_number=123
      timezone=America/Los_Angeles
      plan_id=10
      commission_structure=1
      disable_billing_access=0
      disable_settings_access=1
      pay_on_signup=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