This is the endpoint used for adding recipients to a survey. It has a limitation of 1000 requests per minute which is reset every minute (at 00:00, not 60 seconds after the last request). Valid Survey id for existing survey needs to be provided.
If your request is made before the previous one has been handled, you will get a CONFLICT error.
We automatically filter out duplicate emails and prevent the same email being uploaded and sent more than once every 10 minutes.
If you need to add a large batch of recipients at once, see our documentation for Bulk API
If adding metatags by score type (e.g. thank_you_note_promoter, thank_you_note_passive, thank_you_note_detractor) they will work only if 'Customise based on score' switch is enabled within the web interface (on the design step of the survey).
For thank_you_link_url and thank_you_link_note to work, you will also need to enable the 'Add a link' switch in the web interface.
Using this endpoint, you can also include properties and metatags
You can only add recipients using our API to our email survey
{
"send_at": "2018-01-01T09:00:00",
"recipient": {
"identity": "[email protected]",
"identity_type": "email",
"first_name": "test_first_name",
"last_name": "test_last_name",
"properties": [
{"name": "country", "value": "Germany"},
{"name": "gender", "value": "male"}
],
"metatags": {
"survey_question": "How likely are you to recommend %[question subject] test_first_name?",
"question_subject": "metatags",
"request_for_comment_all": "Tell us a bit more about why you chose %[score] for metatags",
"thank_you_link_text_all": "example text",
"thank_you_link_url_all": "www.example.com",
"thank_you_note_all": "Thanks for your feedback!"
}
}
}
Response attributes
| Attribute | Type | Description |
|---|---|---|
| survey_recipient | object | Survey recipient information data. |
| survey_recipient.id | string | Survey recipient id. |
| survey_recipient.status | string | Survey recipient status. |
| survey_recipient.recipient | object | Recipient information data. |
| survey_recipient.recipient.id | string | Recipient id. |
| survey_recipient.recipient.email | string | Recipient email. Deprecated |
| survey_recipient.recipient.identity | string | Recipient identity. |
| survey_recipient.recipient.identity_type | string | Recipient identity type. One of: email, custom |
| survey_recipient.recipient.first_name | string | Recipient first name. |
| survey_recipient.recipient.last_name | string | Recipient last_name. |
| survey_recipient.recipient.upload_status | status | Recipient status. One of: new, found |
| survey_recipient.survey.id | string | Survey id. |
| survey_recipient.survey.title | string | Survey title. |
| survey_recipient.survey.status | string | Survey status. |
| survey_recipient.properties | array | List of properties. |
| survey_recipient.properties.name | string | Name of the property. |
| survey_recipient.properties.value | string | Value of the property. |
| survey_recipient.metatags.survey_question | string | Question of the survey containing reference to question_subject. |
| survey_recipient.metatags.question_subject | string | Subject of the question. |
| survey_recipient.metatags.request_for_comment_all | string | Text for comment page regardless of survey recipient score. |
| survey_recipient.metatags.request_for_comment_promoter | string | Text for comment page for promoters. |
| survey_recipient.metatags.request_for_comment_passive | string | Text for comment page for passives. |
| survey_recipient.metatags.request_for_comment_detractor | string | Text for comment page for detractors. |
| survey_recipient.metatags.thank_you_note_all | string | Text for thank you page regardless of survey recipient score. |
| survey_recipient.metatags.thank_you_note_promoter | string | Text for thank you page for promoters. |
| survey_recipient.metatags.thank_you_note_passive | string | Text for thank you page for passives. |
| survey_recipient.metatags.thank_you_note_detractor | string | Text for thank you page for detractors. |
| survey_recipient.metatags.thank_you_link_text_all | string | Text for link on thank you page regardless of survey recipient score. |
| survey_recipient.metatags.thank_you_link_text_promoter | string | Text for link on thank you page for promoters. |
| survey_recipient.metatags.thank_you_link_text_passive | string | Text for link on thank you page for passives. |
| survey_recipient.metatags.thank_you_link_text_detractor | string | Text for link on thank you page for detractors. |
| survey_recipient.metatags.thank_you_link_url_all | string | URL for link on thank you page regardless of survey recipient score. |
| survey_recipient.metatags.thank_you_link_url_promoter | string | URL for link on thank you page for promoters. |
| survey_recipient.metatags.thank_you_link_url_passive | string | URL for link on thank you page for passives. |
| survey_recipient.metatags.thank_you_link_url_detractor | string | URL for link on thank you page for detractors. |