Fetch an Email

This operation fetches a single Email using its ID.

Authentication

AuthorizationBasic

Basic authentication of the form Basic <account_id:auth_token>.

AuthorizationBasic

Basic authentication of the form Basic <api_key:api_key_secret>.

Path parameters

emailIdstringRequired

Response

bcclist of objects

cclist of objects

contentobject

The resolved content of the Email. If no plain/text MIME is provided, one will be generated from the text/html MIME.

createdAtstringformat: "date-time"

deletedAtstring or nullformat: "date-time"

fromobject

idstringformat: "^comms_email_[0-7][a-hjkmnpqrstv-z0-9]{25,34}"

A reference to an Email.

replyTolist of objects

scheduledForstring or nullformat: "date-time"

statusenum

The status of an Email. The status can be one of the following:

SCHEDULED The Email is scheduled to be sent by Twilio in the future.
QUEUED The Email is queued in Twilio for sending.
SENT The Email has been sent by Twilio.
DELIVERED The Email has been successfully delivered to the recipient.
UNDELIVERED The Email was successfully sent by Twilio but has not been delivered to the recipient.
OPENED The Email has been opened by the recipient.
FAILED The Email processing failed inside Twilio. Use GET /Emails/Operations/{operationId}/Errors for more details.
CANCELED The Email was canceled via API request.
INBOUND The Email was received by Twilio from an external source.

The status of an `Email`. The status can be one of the following: - `SCHEDULED` The `Email` is scheduled to be sent by Twilio in the future. - `QUEUED` The `Email` is queued in Twilio for sending. - `SENT` The `Email` has been sent by Twilio. - `DELIVERED` The `Email` has been successfully delivered to the recipient. - `UNDELIVERED` The `Email` was successfully sent by Twilio but has not been delivered to the recipient. - `OPENED` The `Email` has been opened by the recipient. - `FAILED` The `Email` processing failed inside Twilio. Use `GET /Emails/Operations/{operationId}/Errors` for more details. - `CANCELED` The `Email` was canceled via API request. - `INBOUND` The `Email` was received by Twilio from an external source.

tagsmap from strings to strings

Custom metadata in the form of key-value pairs. Maximum size of a tag key is 128 characters. Maximum size of a tag value is 256 characters. There can be a maximum of 10 key-value pairs.

This field can be templated with Liquid. Specify variables with each recipient for personalization.

Custom metadata in the form of key-value pairs. Maximum size of a tag key is 128 characters. Maximum size of a tag value is 256 characters. There can be a maximum of 10 key-value pairs. This field can be templated with [Liquid](https://shopify.github.io/liquid/). Specify `variables` with each recipient for personalization.

tolist of objects

updatedAtstringformat: "date-time"

Errors

The status of an Email. The status can be one of the following:

SCHEDULED The Email is scheduled to be sent by Twilio in the future.
QUEUED The Email is queued in Twilio for sending.
SENT The Email has been sent by Twilio.
DELIVERED The Email has been successfully delivered to the recipient.
UNDELIVERED The Email was successfully sent by Twilio but has not been delivered to the recipient.
OPENED The Email has been opened by the recipient.
FAILED The Email processing failed inside Twilio. Use GET /Emails/Operations/{operationId}/Errors for more details.
CANCELED The Email was canceled via API request.
INBOUND The Email was received by Twilio from an external source.

1	{
2	"bcc": [],
3	"cc": [
4	{
5	"address": "jane.doe@example.com",
6	"name": "Jane Doe"
7	}
8	],
9	"content": {
10	"text": "Hello, World!",
11	"subject": "An Introduction",
12	"html": "<html><body>Hello, World!</body></html>",
13	"attachments": []
14	},
15	"createdAt": "2023-08-24T14:15:22Z",
16	"deletedAt": "2024-01-15T09:30:00Z",
17	"from": {
18	"address": "support@example.com",
19	"name": "Cool Support"
20	},
21	"id": "comms_email_01h9krwprkeee8fzqspvwy6nq8",
22	"related": [
23	{
24	"name": "OPERATION",
25	"id": "comms_operation_01h9krwprkeee8fzqspvwy6nq8",
26	"uri": "https://comms.twilio.com/v1/Emails/Operations/comms_operation_01h9krwprkeee8fzqspvwy6nq8"
27	},
28	{
29	"name": "SESSION",
30	"id": "comms_session_01h9krwprkeee8fzqspvwy6nq8",
31	"uri": "https://comms.twilio.com/v1/Sessions/comms_session_01h9krwprkeee8fzqspvwy6nq8"
32	},
33	{
34	"name": "SENDER",
35	"id": "comms_sender_01h9krwprkeee8fzqspvwy6nq8",
36	"uri": "https://comms.twilio.com/v1/Senders/comms_sender_01h9krwprkeee8fzqspvwy6nq8"
37	}
38	],
39	"replyTo": [],
40	"scheduledFor": "2024-01-15T09:30:00Z",
41	"status": "OPENED",
42	"tags": {},
43	"to": [
44	{
45	"address": "janedoe@example.com",
46	"name": "Jane Doe"
47	}
48	],
49	"updatedAt": "2023-08-24T14:15:22Z"
50	}

1	curl https://comms.twilio.com/v1/Emails/emailId \
2	-u "<accountId>:<authToken>"