POST: https://{{env}}-api.xebo.ai/v2/api/collectors/{{collect_id}}/campaigns/externalThe value of environment {{env}} variable depends upon your datacenter. Refer to the Environment page for more details.
Headers
"Content-Type": "application/json"Authorization
Authorization:
type: Bearer type
token: <access token> granted from login API
Or
x-api-key: <api key copied from the platform>
Content-Type: application/json Payload
{
"collectortoken": "E/f1a0f500",
"contacts": [{
"extUniqueId": "john1@s2c.com",
"city": "Delhi"
}, {
"extUniqueId": "john2@s2c.com",
"city": "Mumbai"
}]
} Supported Filters
Field | Type | Mandatory | Description |
|---|---|---|---|
collectortoken | String | Yes | It is unique for every collector. Can be captured from the platform. |
contacts | Array | Yes | Array for contacts to whom you want to trigger surveys. Also, you can send custom information of the respondents along with it. ‘email’ field is mandatory for medium 2. ‘mobile’ field is mandatory for medium 1. |
Request Sample
cURL
curl --location 'https://az4-api.xebo.ai/v2/api/collectors/66c70e71f57bd9efe12d691d/campaigns/external' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzI0Mzk2ODA1LCJpYXQiOjE3MjQzMTA0MDUsImp0aSI6IjQ4ZmM1YTIxNDNmODQ5MjdhZWY5YTZmZjlmOWU5ODZjIiwidXNlcl9pZCI6IjJkNWQxMTk5LTY4ZTUtNDMyMC1hMjEyLWM2ZjQ1NWU3ZDljYyIsImN1c3RvbV9jbGFpbSI6Ikg0c0lBSVhqeG1ZQy80MVh1WkxqTmhEOWxTbkZabGtIZFczbXhJbERPMGMxZ1NhRkZRaGdBVkFhemRiOHV4dWtKSkxpTVpPSmVOMUFINjhQL1Y1NDlGNGF6YVJZL0hoYnBBZWU4VndjazN5ZFk1S0NTSlBzdUJISkhuYmIvZUc0MysxVHZ2ampiU0U5QTFGS1RUckJWVWducGRHRnVkK3kyNjN5NDFMa1c3RmNiWFo4bGVmYmZMTmFZdFEwcmdBdFBZVDIwVTI2U3RQMWVwTmtKSldrcSsyYWZtMzN5WUducXd3UGgvMHl5Nk9xSUxWTUlRc08rRm5xZ25SelVENitqcnBHU3ZBdmdFTWZuT1FCQlpPV2JCWjBRQzZUaEs2VUlvRVBvekVhQVI5cGZNTVpGVDkvTDZxcU1XNjFQK3pTN1hxZHJMZTdkWkttUjBpeTFXR1pwSnNEN05JVTErbjJFQlhyY0VoNmpEeTdJTE5RSUFQTzZiVTJSaTh5cjNEbDBiSFNDSm5meGpHQkNzTlFMOW84cFZkakUzcStjaGU4VFIxUFhIaEhiWlVwNlU4RFdJQS9aUWFjbUVFbWJtNEZwaTdubFErbXBFRDhOSlhUMFViUUZPY1NkWmdSK3ZxV2NYc0djaE5oNUVZcDVNRzRBWUlsU01XbWNWLzZHZlI2Z3VEQjJoa1JzSElPcllSRXpYRkdKSmVvQk11Tm01WGl4TmM1K0lrNEpJSUxkSDVvaXdaMSs4REpjM3kzeG9VaGZkRmJvLzAwdlIvNFJHNmtEbGk0cHRrTW9nOEtmZVA2bkZoT2I1d0Urdk9zbERWWFlrb21aNFdDNUdjTTFLQm1rQWxIVzRFSlQxc0I3aEJJd0FjSWxmL0dTOVQvQzQzNHRhU29LTTR3K3pZb3hab3ZQODZpOGNPaXFlQkgwNjRQSCtaRmJGenRFWWxwaWE5Y2JGNnZVVGJSRGUvM2FCbjViZEVSWWFqcjhIR3FFWmRzbUVwaEt6QkQxa1pnV0dFNmwwWGxrQlVVL3lzTUw0ZkdEMG82eGVMdWlxK0tnc1lmTWRGL1MxNXFDc1FwakFxL1kyWVlEV0NPVGs4NUdQdE5ZTXE4MFBzekZoRlJNcHJ2TWRUVFZVTlpUOTMvbkFUMTluZUR2djFMYUx4SEtYTzlHOVc1dlQ1OURvbFg0TW5CVitBWjFVN1hnSnFzMXBuTy9nSzBKN3hUQlZ1andMWG4yblk4TEN0RmJPZ2QwVWYvSXE4a2RjQlhuZGZUWE1hNTdJRHEyUm43Y3A1Vklaak9ibVVwVlZkRGc1R1lqclROakNBbTJHNVg1R0FEUDBFL040WmR5QWpUWFNvZ2swcUdHd3VSSjkzWUVVWGhSa3RUNW9qc3B4NWtiRU1wWW9NbG9SYjRWVFZzR3lJVW9OS0VydjhYb016SGxhMnB2djRJdDA0YVIyWjF6UStHeUJQSFRLOHFpSEQwSUNoMkFRcHczWFc3YWRiQ2xQZGRzejFXeHRpZVF4eWN1OFVoZU8zeHFrNmNJc2tLVk1jMjJWZitWWmtBM1ZaWWR0MXNkZ2dXVHJTa2RCc21saFNnZ0lOdGcvSGhCc0k4ZDlMMjAxTVlVOFRneGVsSnpPOXRVUUh1MDdRWHFaOUd4aTRaRmFqc3U3eC9wM3psK1FqRW5mR2VCY2hHTUlmMXZQYjhoS0pTUTVmYnRhbFRHWlJrV2VLb0dkYWhvRFU5cnNYbnVHbzUrdVZHNUx6aDFERVlyWWNCZForV3BaWkVlYTJ4czNKTnJFcHpPMUl2YW1SRVF4OFl2WFIwZmVvWUs4Nmo5L2JXcWRGbHBkOThhZmUvU0k3ZmIvZmY2L1A5TjBxZ2ZENUwrS3NSTUlJUDB6dWNBd3BpT1JWMTcwZTl1QmZNNHovWVgxN0NuLzhZZFNZT1I0eHFSTmZqZ3Znc3FVVGo4aEhsRnArZi93T08wYVordVE0QUFBPT0ifQ.4h7MKol3jaNyuDU_jOwrSW4FiW-kiGTfnGBjAdbOLJc' \
--data-raw '{
"collectortoken": "J/d5730267",
"contacts": [{
"extUniqueId": "john1@s2c.com",
"city": "Delhi"
}, {
"extUniqueId": "john2@s2c.com",
"city": "Mumbai"
}]
}JavaScript
var data = JSON.stringify({
"collectortoken": "J/d5730267",
"contacts": [
{
"extUniqueId": "john1@s2c.com",
"city": "Delhi"
},
{
"extUniqueId": "john2@s2c.com",
"city": "Mumbai"
}
]
});
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://az4-api.xebo.ai/v2/api/collectors/66c70e71f57bd9efe12d691d/campaigns/external");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("Authorization", "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzI0Mzk2ODA1LCJpYXQiOjE3MjQzMTA0MDUsImp0aSI6IjQ4ZmM1YTIxNDNmODQ5MjdhZWY5YTZmZjlmOWU5ODZjIiwidXNlcl9pZCI6IjJkNWQxMTk5LTY4ZTUtNDMyMC1hMjEyLWM2ZjQ1NWU3ZDljYyIsImN1c3RvbV9jbGFpbSI6Ikg0c0lBSVhqeG1ZQy80MVh1WkxqTmhEOWxTbkZabGtIZFczbXhJbERPMGMxZ1NhRkZRaGdBVkFhemRiOHV4dWtKSkxpTVpPSmVOMUFINjhQL1Y1NDlGNGF6YVJZL0hoYnBBZWU4VndjazN5ZFk1S0NTSlBzdUJISkhuYmIvZUc0MysxVHZ2ampiU0U5QTFGS1RUckJWVWducGRHRnVkK3kyNjN5NDFMa1c3RmNiWFo4bGVmYmZMTmFZdFEwcmdBdFBZVDIwVTI2U3RQMWVwTmtKSldrcSsyYWZtMzN5WUducXd3UGgvMHl5Nk9xSUxWTUlRc08rRm5xZ25SelVENitqcnBHU3ZBdmdFTWZuT1FCQlpPV2JCWjBRQzZUaEs2VUlvRVBvekVhQVI5cGZNTVpGVDkvTDZxcU1XNjFQK3pTN1hxZHJMZTdkWkttUjBpeTFXR1pwSnNEN05JVTErbjJFQlhyY0VoNmpEeTdJTE5RSUFQTzZiVTJSaTh5cjNEbDBiSFNDSm5meGpHQkNzTlFMOW84cFZkakUzcStjaGU4VFIxUFhIaEhiWlVwNlU4RFdJQS9aUWFjbUVFbWJtNEZwaTdubFErbXBFRDhOSlhUMFViUUZPY1NkWmdSK3ZxV2NYc0djaE5oNUVZcDVNRzRBWUlsU01XbWNWLzZHZlI2Z3VEQjJoa1JzSElPcllSRXpYRkdKSmVvQk11Tm01WGl4TmM1K0lrNEpJSUxkSDVvaXdaMSs4REpjM3kzeG9VaGZkRmJvLzAwdlIvNFJHNmtEbGk0cHRrTW9nOEtmZVA2bkZoT2I1d0Urdk9zbERWWFlrb21aNFdDNUdjTTFLQm1rQWxIVzRFSlQxc0I3aEJJd0FjSWxmL0dTOVQvQzQzNHRhU29LTTR3K3pZb3hab3ZQODZpOGNPaXFlQkgwNjRQSCtaRmJGenRFWWxwaWE5Y2JGNnZVVGJSRGUvM2FCbjViZEVSWWFqcjhIR3FFWmRzbUVwaEt6QkQxa1pnV0dFNmwwWGxrQlVVL3lzTUw0ZkdEMG82eGVMdWlxK0tnc1lmTWRGL1MxNXFDc1FwakFxL1kyWVlEV0NPVGs4NUdQdE5ZTXE4MFBzekZoRlJNcHJ2TWRUVFZVTlpUOTMvbkFUMTluZUR2djFMYUx4SEtYTzlHOVc1dlQ1OURvbFg0TW5CVitBWjFVN1hnSnFzMXBuTy9nSzBKN3hUQlZ1andMWG4yblk4TEN0RmJPZ2QwVWYvSXE4a2RjQlhuZGZUWE1hNTdJRHEyUm43Y3A1Vklaak9ibVVwVlZkRGc1R1lqclROakNBbTJHNVg1R0FEUDBFL040WmR5QWpUWFNvZ2swcUdHd3VSSjkzWUVVWGhSa3RUNW9qc3B4NWtiRU1wWW9NbG9SYjRWVFZzR3lJVW9OS0VydjhYb016SGxhMnB2djRJdDA0YVIyWjF6UStHeUJQSFRLOHFpSEQwSUNoMkFRcHczWFc3YWRiQ2xQZGRzejFXeHRpZVF4eWN1OFVoZU8zeHFrNmNJc2tLVk1jMjJWZitWWmtBM1ZaWWR0MXNkZ2dXVHJTa2RCc21saFNnZ0lOdGcvSGhCc0k4ZDlMMjAxTVlVOFRneGVsSnpPOXRVUUh1MDdRWHFaOUd4aTRaRmFqc3U3eC9wM3psK1FqRW5mR2VCY2hHTUlmMXZQYjhoS0pTUTVmYnRhbFRHWlJrV2VLb0dkYWhvRFU5cnNYbnVHbzUrdVZHNUx6aDFERVlyWWNCZForV3BaWkVlYTJ4czNKTnJFcHpPMUl2YW1SRVF4OFl2WFIwZmVvWUs4Nmo5L2JXcWRGbHBkOThhZmUvU0k3ZmIvZmY2L1A5TjBxZ2ZENUwrS3NSTUlJUDB6dWNBd3BpT1JWMTcwZTl1QmZNNHovWVgxN0NuLzhZZFNZT1I0eHFSTmZqZ3Znc3FVVGo4aEhsRnArZi93T08wYVordVE0QUFBPT0ifQ.4h7MKol3jaNyuDU_jOwrSW4FiW-kiGTfnGBjAdbOLJc");
xhr.send(data); Responses
{
"msg": "Request data is correct",
"data": [
{
"extUniqueId": "123",
"message": "We are conducting a survey and your input would be appreciated. Open the link below to start the survey. Thank you for your participation! https://s2ccx.com/7gtdu4U"
},
{
"extUniqueId": "124",
"message": "We are conducting a survey and your input would be appreciated. Open the link below to start the survey. Thank you for your participation! https://s2ccx.com/txsXRkF"
}
],
"rejected_list": [],
"accepted": 2,
"rejected": 0
} {
"error": {
"name": "Bad Request",
"message": "Collector not found"
}
}{
"error": {
"name": "Unauthorized",
"message": "The authorization token was not provided."
}
}{
"error": {
"name": "Internal Server Error",
"message": "We were not able to process your request"
}
} Note: Please do not share your tokens in publicly accessible areas or to anyone. Also, this token generated is valid for 24 hours only. After its expiry, you can regenerate the access token from the same API endpoint by passing the username and password or from the refresh token API with the help of refresh token.
Ask a human