This is an old revision of the document!
/api/applicants/ID/emails
HEAD, GET
Get a list of emails that have been sent to this applicant. Note that this list will only shows emails that have been stored. Any emails containing credentials or other secrets (for example password reminders) are delivered immediately without storing them to the database, an are therefore unavailable here as well.
Note that you can also see when the email was delivered and when it was opened (this may not be accurate). If the email is still being delivered, the timestamp contains a NULL.
Syntax
GET /api/applicants/123/emails Host: apply.example.edu Authorization: DREAM apikey="..."
Response headers
Content-Type: application/json Content-Length: 1456
Example response
{
"123": {
"inserted": "2014-06-29T18:11:15+00:00",
"delivered": "2014-06-29T18:11:15+00:00",
"failed": NULL,
"opened": "2014-06-30T10:15:49+00:00",
"from": {
"email": "sender@uni.edu",
"name": "Admission Office"
},
"subject": "Hello world!",
"message": "Hi there!",
"attachments": "/api/applicants/1/emails/123/attachments"
},
"321": {
"inserted": "2014-07-10T19:21:55+00:00",
"delivered": NULL,
"failed": NULL,
"opened": NULL,
"from": {
"email": "sender@uni.edu",
"name": "Admission Office"
},
"subject": "Hello world!",
"message": "Hi there!",
"attachments": NULL
}
}
POST
Create and send a new email to the applicant. Note that after the email is created, it may take a few minutes for it to be delivered. The URI for the email created is returned in the Location header and you can poll this URI after a few minutes to see if it was delivered successfully.
Please note that this feature is not enabled by default. Please contact the support team to be white-listed.
Syntax
POST /api/applicants/123/emails Host: apply.example.edu Authorization: DREAM apikey="..."
Parameters
| Name | Description | |
|---|---|---|
subject | Required | This is the email subject line. 2 to 128 characters. |
message | Required | This is the email message itself in text form. 4 to 4096 characters. Note that you can use basic Textile syntax here like *bold*. The HTML version of the email is generated by DreamApply. |
Response headers
Content-Type: application/json Content-Length: 0 Location: /api/applicants/123/emails/321
Response codes
201 Created | New email was created (does not yet mean it was delivered) |
400 Bad Request | Some of the email parameters were not correct |
403 Forbidden | You have not been white-listed to use use this feature |