API Query Parameters

The API accepts either a single dsid (DailyStory unique id) or a comma separated list of email addresses. If email query string parameter has a value, the dsid value will be ignored.

• email - The email parameter accepts a single example address, e.g. [email protected], or a comma separate list of email addresses, e.g. [email protected],[email protected]

Any email addresses that are invalid or are attempted to be used for invalid contacts will be ignored.

JSON Body

Optionally include a JSON body with properties used to personalize the email.

{
  "subject":"My new email subject",						// optional to set a subject
  "from":"[email protected]",									// optional set a from address
  "confirmation_url":"https://example.com",		// optional set a profile field
  "confirmation_code":"confirmation-38474"		// optional set a profile field
}

These fields are then accessible in the email. The following fields are reserved field and for a templated email that is sent these fields are usually already set.

• subject - set an alternate subject for the email.
• from - set an alternate from address for the email.
• preheader- set an alternate preheader for the email.
• plaintext- set an alternate plaintext for the email.
• cc - carbon copy recipients. Must be in standard email format. Multiple addresses should be separated with a semi-colon.
• bcc - blind carbon copy recipient. Must be in standard email format. Multiple addresses should be separated with a semi-colon.
• reply-to - set the reply-to header of the email. Must be in standard email format. Only a single address is allowed.

For example:

Hello, your confirmation code is{{profile.confirmation_code}}.

It's also possible to send a subject or from with a personalization token, for example:

{
  "subject":"Your id is {{@profile.custom_id}}"
}

When the email is sent if the contact has a personalization field of custom_id it will automatically be inserted.