IM
ZH-TW
文件首頁
選單

Contents

Email endpoints

GET/api/accounts/{account_id}/emails

List stored email records for an account. More Email Ingestion & Delivery

Responses
200application/json
OK
schemaobject
dataarrayrequired
itemEmailMessagerequired
Stored email metadata and envelope details for inbound sync and outbound delivery records.
idstringrequired
Email message identifier.
account_idstringrequired
Account identifier.
application_idstringrequired
Application identifier.
credential_idstring | nullrequired
Provider credential identifier.
directionrequired
folderstring | nullrequired
provider_message_idstring | nullrequired
thread_idstring | nullrequired
subjectstring | nullrequired
from_jsonarrayrequired
Nested fields truncated. Expand to continue inline, or use the model link.
to_jsonarrayrequired
Nested fields truncated. Expand to continue inline, or use the model link.
cc_jsonarrayrequired
Nested fields truncated. Expand to continue inline, or use the model link.
bcc_jsonarrayrequired
Nested fields truncated. Expand to continue inline, or use the model link.
headers_jsonobjectrequired
snippetstring | nullrequired
staterequired
received_atstring | nullrequired
sent_atstring | nullrequired
created_bystringrequired
User identifier.
updated_bystringrequired
User identifier.
created_atstringrequired
updated_atstringrequired
deleted_atstring | nullrequired
meta
linksobjectrequired
selfstringrequired
URL of the current page
nextstring
URL of the next page
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
POST/api/accounts/{account_id}/emails

Create a stored email record and optional body/attachment metadata. More Email Ingestion & Delivery

Body application/json
credential_idstring | null
Provider credential identifier.
directionrequired
available_atstring · date-time | null
folderstring | null
provider_message_idstring | null
thread_idstring | null
subjectstring | null
from_jsonarray
itemobjectrequired
namestring | null
addressstringrequired
to_jsonarray
itemobjectrequired
namestring | null
addressstringrequired
cc_jsonarray
itemobjectrequired
namestring | null
addressstringrequired
bcc_jsonarray
itemobjectrequired
namestring | null
addressstringrequired
headers_jsonobject
snippetstring | null
text_bodystring | null
html_bodystring | null
attachmentsarray
itemobjectrequired
filenamestringrequired
content_typestringrequired
content_b64stringrequired
disposition
content_idstring | null
state
received_atstring | null
sent_atstring | null
Responses
201application/json
Created
schemaobject
dataEmailMessagerequired
Stored email metadata and envelope details for inbound sync and outbound delivery records.
idstringrequired
Email message identifier.
account_idstringrequired
Account identifier.
application_idstringrequired
Application identifier.
credential_idstring | nullrequired
Provider credential identifier.
directionrequired
folderstring | nullrequired
provider_message_idstring | nullrequired
thread_idstring | nullrequired
subjectstring | nullrequired
from_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
to_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
cc_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
bcc_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
headers_jsonobjectrequired
snippetstring | nullrequired
staterequired
received_atstring | nullrequired
sent_atstring | nullrequired
created_bystringrequired
User identifier.
updated_bystringrequired
User identifier.
created_atstringrequired
updated_atstringrequired
deleted_atstring | nullrequired
linksobjectrequired
selfstringrequired
URL of the current resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
GET/api/accounts/{account_id}/emails/{email_id}/body

Fetch normalized text/html body plus embedded and attachment payloads. More Email Ingestion & Delivery

Responses
200application/json
OK
schemaobject
dataobjectrequired
subjectstring | nullrequired
from_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
to_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
cc_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
bcc_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
textstring | nullrequired
htmlstring | nullrequired
headers_jsonobjectrequired
embedded_partsarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
attachmentsarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
linksobjectrequired
selfstringrequired
URL of the current resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
GET/api/accounts/{account_id}/emails/{email_id}/parts

List attachment and embedded-part metadata for an email. More Email Ingestion & Delivery

Responses
200application/json
OK
schemaobject
dataarrayrequired
itemEmailMessagePartrequired
Metadata for a persisted embedded part or attachment belonging to a stored email message.
idstringrequired
Email message part identifier.
email_idstringrequired
Email message identifier.
account_idstringrequired
Account identifier.
application_idstringrequired
Application identifier.
kindrequired
ordinalintegerrequired
filenamestring | nullrequired
content_typestringrequired
dispositionstring | nullrequired
content_idstring | nullrequired
sizeintegerrequired
content_sha256string | nullrequired
created_atstringrequired
updated_atstringrequired
meta
linksobjectrequired
selfstringrequired
URL of the current page
nextstring
URL of the next page
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
GET/api/accounts/{account_id}/emails/{email_id}/parts/{part_id}/content

Fetch decoded content for a specific stored email part. More Email Ingestion & Delivery

Responses
200application/json
OK
schemaobject
Full content payload for a stored email part.
idstringrequired
Email message part identifier.
email_idstringrequired
Email message identifier.
kindrequired
ordinalintegerrequired
filenamestring | nullrequired
content_typestringrequired
dispositionstring | nullrequired
content_idstring | nullrequired
sizeintegerrequired
content_sha256string | nullrequired
content_b64stringrequired
linksobjectrequired
selfstringrequired
URL of the current resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
POST/api/accounts/{account_id}/emails/{email_id}/parts/search

Search attachment and embedded-part metadata for an email by query expression with optional kind filter. More Email Ingestion & Delivery

Body application/json
querystringrequired
kind
limitinteger
offsetinteger
Responses
200application/json
OK
schemaobject
dataarrayrequired
itemEmailMessagePartrequired
Metadata for a persisted embedded part or attachment belonging to a stored email message.
idstringrequired
Email message part identifier.
email_idstringrequired
Email message identifier.
account_idstringrequired
Account identifier.
application_idstringrequired
Application identifier.
kindrequired
ordinalintegerrequired
filenamestring | nullrequired
content_typestringrequired
dispositionstring | nullrequired
content_idstring | nullrequired
sizeintegerrequired
content_sha256string | nullrequired
created_atstringrequired
updated_atstringrequired
meta
linksobjectrequired
selfstringrequired
URL of the current page
nextstring
URL of the next page
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
POST/api/accounts/{account_id}/emails/search

Search stored email records by query expression. More Email Ingestion & Delivery

Body application/json
querystringrequired
limitinteger
offsetinteger
Responses
200application/json
OK
schemaobject
dataarrayrequired
itemEmailMessagerequired
Stored email metadata and envelope details for inbound sync and outbound delivery records.
idstringrequired
Email message identifier.
account_idstringrequired
Account identifier.
application_idstringrequired
Application identifier.
credential_idstring | nullrequired
Provider credential identifier.
directionrequired
folderstring | nullrequired
provider_message_idstring | nullrequired
thread_idstring | nullrequired
subjectstring | nullrequired
from_jsonarrayrequired
Nested fields truncated. Expand to continue inline, or use the model link.
to_jsonarrayrequired
Nested fields truncated. Expand to continue inline, or use the model link.
cc_jsonarrayrequired
Nested fields truncated. Expand to continue inline, or use the model link.
bcc_jsonarrayrequired
Nested fields truncated. Expand to continue inline, or use the model link.
headers_jsonobjectrequired
snippetstring | nullrequired
staterequired
received_atstring | nullrequired
sent_atstring | nullrequired
created_bystringrequired
User identifier.
updated_bystringrequired
User identifier.
created_atstringrequired
updated_atstringrequired
deleted_atstring | nullrequired
meta
linksobjectrequired
selfstringrequired
URL of the current page
nextstring
URL of the next page
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
POST/api/accounts/{account_id}/emails/search-delete

Delete emails selected by query with optional dry-run confirmation. More Email Ingestion & Delivery

Body application/json
querystringrequired
dry_runboolean
confirmboolean
limitinteger
older_thanstring · date-timerequired
Responses
200application/json
OK
schemaobject
dataobjectrequired
deleted_countintegerrequired
deleted_idsarrayrequired
itemstringrequired
dry_runbooleanrequired
linksobjectrequired
selfstringrequired
URL of the current resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
POST/api/accounts/{account_id}/imap/sync-mailboxes

Queue mailbox discovery for a provider credential. More Email Ingestion & Delivery

Body application/json
credential_idstringrequired
Provider credential identifier.
Responses
202application/json
Accepted
schemaobject
dataobjectrequired
statusrequired
task_idstringrequired
Task identifier.
linksobjectrequired
selfstringrequired
URL of the current resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
POST/api/accounts/{account_id}/imap/sync-messages

Queue message synchronization for a provider credential and folder scope. More Email Ingestion & Delivery

Body application/json
credential_idstringrequired
Provider credential identifier.
folderstring | null
available_atstring · date-time | null
repeat_interval_secondsinteger | null
repeat_runsinteger | null
Responses
202application/json
Accepted
schemaobject
dataobjectrequired
statusrequired
task_idstringrequired
Task identifier.
linksobjectrequired
selfstringrequired
URL of the current resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
POST/api/accounts/{account_id}/smtp/messages

Queue outbound SMTP message delivery. More Email Ingestion & Delivery

Body application/json
credential_idstringrequired
Provider credential identifier.
directionrequired
available_atstring · date-time | null
folderstring | null
provider_message_idstring | null
thread_idstring | null
subjectstring | null
from_jsonarray
itemobjectrequired
namestring | null
addressstringrequired
to_jsonarray
itemobjectrequired
namestring | null
addressstringrequired
cc_jsonarray
itemobjectrequired
namestring | null
addressstringrequired
bcc_jsonarray
itemobjectrequired
namestring | null
addressstringrequired
headers_jsonobject
snippetstring | null
text_bodystring | null
html_bodystring | null
attachmentsarray
itemobjectrequired
filenamestringrequired
content_typestringrequired
content_b64stringrequired
disposition
content_idstring | null
state
received_atstring | null
sent_atstring | null
Responses
202application/json
Accepted
schemaobject
dataobjectrequired
statusrequired
task_idstringrequired
Task identifier.
linksobjectrequired
selfstringrequired
URL of the current resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
DELETE/api/emails/{email_id}

Delete a stored email record. More Email Ingestion & Delivery

Responses
204
No Content
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
GET/api/emails/{email_id}

Retrieve one stored email record by ID. More Email Ingestion & Delivery

Responses
200application/json
OK
schemaobject
dataEmailMessagerequired
Stored email metadata and envelope details for inbound sync and outbound delivery records.
idstringrequired
Email message identifier.
account_idstringrequired
Account identifier.
application_idstringrequired
Application identifier.
credential_idstring | nullrequired
Provider credential identifier.
directionrequired
folderstring | nullrequired
provider_message_idstring | nullrequired
thread_idstring | nullrequired
subjectstring | nullrequired
from_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
to_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
cc_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
bcc_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
headers_jsonobjectrequired
snippetstring | nullrequired
staterequired
received_atstring | nullrequired
sent_atstring | nullrequired
created_bystringrequired
User identifier.
updated_bystringrequired
User identifier.
created_atstringrequired
updated_atstringrequired
deleted_atstring | nullrequired
linksobjectrequired
selfstringrequired
URL of the current resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
PATCH/api/emails/{email_id}

Update mutable email metadata fields. More Email Ingestion & Delivery

Body application/json
folderstring | null
subjectstring | null
snippetstring | null
state
deleted_atstring | null
Responses
200application/json
OK
schemaobject
dataEmailMessagerequired
Stored email metadata and envelope details for inbound sync and outbound delivery records.
idstringrequired
Email message identifier.
account_idstringrequired
Account identifier.
application_idstringrequired
Application identifier.
credential_idstring | nullrequired
Provider credential identifier.
directionrequired
folderstring | nullrequired
provider_message_idstring | nullrequired
thread_idstring | nullrequired
subjectstring | nullrequired
from_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
to_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
cc_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
bcc_jsonarrayrequired
itemobjectrequired
Nested fields truncated. Expand to continue inline, or use the model link.
headers_jsonobjectrequired
snippetstring | nullrequired
staterequired
received_atstring | nullrequired
sent_atstring | nullrequired
created_bystringrequired
User identifier.
updated_bystringrequired
User identifier.
created_atstringrequired
updated_atstringrequired
deleted_atstring | nullrequired
linksobjectrequired
selfstringrequired
URL of the current resource
400application/problem+jsonValidationProblemDetails
Bad Request
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring
defaultapplication/problem+jsonProblemDetails
HTTP Error
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring

Models

EmailMessage
idstringrequired
Email message identifier.
account_idstringrequired
Account identifier.
application_idstringrequired
Application identifier.
credential_idstring | nullrequired
Provider credential identifier.
directionrequired
folderstring | nullrequired
provider_message_idstring | nullrequired
thread_idstring | nullrequired
subjectstring | nullrequired
from_jsonarrayrequired
itemobjectrequired
namestring | null
addressstringrequired
to_jsonarrayrequired
itemobjectrequired
namestring | null
addressstringrequired
cc_jsonarrayrequired
itemobjectrequired
namestring | null
addressstringrequired
bcc_jsonarrayrequired
itemobjectrequired
namestring | null
addressstringrequired
headers_jsonobjectrequired
snippetstring | nullrequired
staterequired
received_atstring | nullrequired
sent_atstring | nullrequired
created_bystringrequired
User identifier.
updated_bystringrequired
User identifier.
created_atstringrequired
updated_atstringrequired
deleted_atstring | nullrequired
EmailMessagePart
idstringrequired
Email message part identifier.
email_idstringrequired
Email message identifier.
account_idstringrequired
Account identifier.
application_idstringrequired
Application identifier.
kindrequired
ordinalintegerrequired
filenamestring | nullrequired
content_typestringrequired
dispositionstring | nullrequired
content_idstring | nullrequired
sizeintegerrequired
content_sha256string | nullrequired
created_atstringrequired
updated_atstringrequired
EmailMessagePartContent
idstringrequired
Email message part identifier.
email_idstringrequired
Email message identifier.
kindrequired
ordinalintegerrequired
filenamestring | nullrequired
content_typestringrequired
dispositionstring | nullrequired
content_idstring | nullrequired
sizeintegerrequired
content_sha256string | nullrequired
content_b64stringrequired
ProblemDetails
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
ValidationProblemDetails
typestring · urirequired
titlestringrequired
statusintegerrequired
detailstring
instancestring · uri
codestring
invalid_paramsarray
itemobjectrequired
instring
pathstring
typestring
expectedstring
receivedstring