Mailing

List of operations for resource

Name	URL	Description
List of mailing templates	`/mailing/templates`	Returns a list of all mailing templates for a logged in user. Templates sorted by date of adding (ascending).
Mailing invitations using batch_id	`/mailing/batch`	Operation for defining mailing. To define a mailing, you have to add respondents to the patch

Description of parameter responses

Name/path	Description	Possible values
`id`	Survey id
`name`	Template title
`subject`	Mailing subject title
`content`	Mailing content
`date_created`	Date of template creation
`id_mailing`	ID of the mailing created in the system
`receivers`	Number of respondents who will receive an invitation
`footer`	possibility of disabling the footer with information about the sender. The footer is enabled by default

List of mailing templates

URL

(GET) https://www.startquestion.com/api/v2/mailing/templates

Optional parameters (POST)

None

Sample response

{
  ["total"] => string(1) "2"
  ["list"] => array(2) {
    [0] => array(5) {
      ["id"] => int(7)
      ["name"] => string(7) "Testowa"
      ["subject"] => string(35) "Zaproszenie do wypełnienia ankiety"
      ["content"] => string(251) "<p>Witaj,<br /> <br /> Zapraszam do wypełnienia ankiety na temat ...<br /> Wypełnienie ankiety powinno zająć około ... minut<br /> <br /> Aby wypełnić ankietę kliknij na link:<br /> [LINK]<br /> <br /> <br /> <br /> Dziękuję i pozdrawiam</p>"
      ["date_created"] => string(19) "2015-04-24 13:36:00"
    }
    [1] => array(5) {
      ["id"] => int(8)
      ["name"] => string(8) "Testowa2"
      ["subject"] => string(35) "Zaproszenie do wypełnienia ankiety"
 <p>testowa 2<br /> <br /> Zapraszam do wypełnienia ankiety na temat ...<br /> Wypełnienie ankiety powinno zająć około ... minut<br /> <br /> Aby wypełnić ankietę kliknij na link:<br /> [LINK]<br /> <br /> <br /> <br /> Dziękuję i pozdrawiam</p>"
      ["date_created"] => string(19) "2015-04-24 13:36:19"
    }
  }
}

Returned errors

None

Mailing invitations using batch_id

POST

(POST) startquestion.com/api/v2/mailing/batch

Parameters (POST)

Name	Description
`batch_id`	Batch ID
`template_id`	ID of the selected template for mailing
`with_reminder`	bool value deciding whether a reminder is to be sent to respondents who did not fill out the survey. Optional parameter Default value: false.
`reminder_template_id`	ID of the selected template for sending reminders. This parameter is required if parametr with_reminder was set to true. How to obtain template_id?
`reminder_delay`	number of hours from mailing after which a reminder is to be sent to respondents who did not fill out the survey. This parameter is required if parameter with_reminder was set to true.

Returned json values:

Name	Description
`mailing_id`	ID of the created mailing