POST Trigger

Dispatch Surveys

POST https://api.feedbackly.com/v5.0.3/triggers/rest/:apiActionId

Dispatch API have rate limit of 500 contacts/minute. Please be careful with retries since we're sending out surveys right away after receiving the API request. *Refer to "Preparing Campaign" to get apiActionId from feedbackly dashboard.

Headers

Name	Type	Description
Authorization	String	Authentication token to access the API eg: 'Authorization': 'ey0iuefg.834xcunerun348efnsd'

Request Body

Name	Type	Description
apiActionId	String	[DEPRECIATED] ApiActionId to be used in body instead of URI param
actionId*	String	Unique identifier to differentiate original requests. Feedbackly will block requests with duplicate actionIds.
contacts*	contact[]	Array of contact objects

200 Response successfully retrieved.

{
  "data": [
    {
      "touchpointName": "Retail location 1",
      "answer": 0.75,
      "questionType": "Button",
      "metadata": {
        "model": "Tesla"
      },
      "valueNum": 0.75,
      "responseChainId": "507f1f77bcf86cd799439011",
      "questionId": "507f1f77bcf86cd799439012",
      "surveyId": "507f1f77bcf86cd799439011",
      "question": "How did we succeed today?",
      "teamId": "507f1f77bcf86cd799439013",
      "createdAtDate": "2019-12-31T10:00:00.000Z",
      "createdAt": 1573507477,
      "touchpointId": "507f1f77bcf86cd799439011",
      "_id": "507f1f77bcf86cd799439011",
      "language": "fi",
      "teamName": "My team name",
      "tags": [
        "CSAT"
      ],
      "browser": "Mac OS X Chrome 84.0.4147.105",
    },
    {
      "answer": 4,
      "valueNum": 4,
      "language": "en",
      "questionType": "NPS",
      "questionId": "58d8d547b8c71e000e3824fd",
      "createdAt": 1490605439,
      "createdAtDate": "2017-03-27T09:03:59.133Z",
      "_id": "5dc57703b7c935069aef31c6",
      "question": "How likely are you to recommend us to a friend or colleague?",
      "metadata": {},
      "responseChainId": "58d8d57d42f73c78c47e2d3d",
      "teamId": "507f1f77bcf86cd799439013",
      "teamName": "My team name",
      "touchpointId": "589c16ad87ef9860199cab37",
      "touchpointName": "Retail location 1",
      "tags": [],
      "browser": "Mac OS X Chrome 84.0.4147.105",
    }
  ],
  "paging": {
    "next": "https://api.feedbackly.com/v5/responses?skip=200",
    "previous": "https://api.feedbackly.com/v5/responses?skip=0"
  }
}Re

Contact Object

Please note that either email or phone must be existing per contact. Metadata and options are optional.

Field	Type	Description
email	String	Valid email address of survey receiver
phone	String	Valid phone number with country code of survey receiver. (with or without + in the beginning)
metadata	{[key:string]: string | number}	Contact related metadata.
options	{}	Additional options

Options

To override default admin notification receivers, use this. Multiple emails can be specified as an array.

"options":{
	"notificationReceiver":["[e-mail]"],
	"overrideDefaultReceivers":true
}