Fastmail (JMAP) email send profile

org.intentschema.communication.email.message.send.v1@com.fastmail.v1

JSON: bare · @sha256:2dfd99917eb3…
Hash: sha256:2dfd99917eb335a2d609c7526f04e71c7a99da334daf19ef54db176043dbeb8d

Profile for sending email via Fastmail's JMAP server (RFC 8621). Pins target.system to fastmail. Exposes JMAP-native concepts: keywords (instead of labels), mailbox ids, sentAt scheduling, and Fastmail's masked-email integration.

Implements: Send email message (org.intentschema.communication.email.message.send.v1)

Payload

FieldTypeDescription
target *Target(system = "fastmail", required: system)
object *object
idempotency_keystring
fastmail @com.fastmailobject
object
FieldTypeDescription
fromstring (email)[]
to *string (email)[] (minItems 1)
ccstring (email)[]
bccstring (email)[]
subject *string
textBodystring
htmlBodystring
attachmentsBlobRef[]
fastmail @com.fastmail
FieldTypeDescription
identity_idstringJMAP IdentityId for the From-address binding.
mailbox_idsstring[]JMAP Mailbox ids the message will appear in once delivered (typically Sent).
keywordsobjectJMAP keywords map (e.g., `{"$flagged": true}`).
sent_atstring (date-time)Scheduled send time (Fastmail supports JMAP delayed delivery).
masked_emailbooleanIf true, request a Fastmail masked-email From-address for outbound delivery.

Result

FieldTypeDescription
external_id *stringProvider message id.
thread_idstring
sent_at *string (date-time)

API mapping

FieldValue
base_urlhttps://api.fastmail.com
methodPOST
path/jmap/api/
jmap_methodEmailSubmission/set
scopesurn:ietf:params:jmap:submission
docshttps://jmap.io/spec-mail.html#emailsubmission

Field mapping

Intent fieldAPI parameter
object.toEmail/set create.to[].email
object.ccEmail/set create.cc[].email
object.bccEmail/set create.bcc[].email
object.fromEmail/set create.from[].email
object.subjectEmail/set create.subject
object.textBodyEmail/set create.textBody[].value (partId ref)
object.htmlBodyEmail/set create.htmlBody[].value (partId ref)
object.attachmentsEmail/set create.attachments[].blobId (upload blob first)
idempotency_keyEmail/set create.messageId[] (RFC 5322 Message-ID)
fastmail.identity_idEmailSubmission/set create.identityId
fastmail.mailbox_idsEmail/set create.mailboxIds
fastmail.keywordsEmail/set create.keywords
fastmail.sent_atEmailSubmission/set create.envelope.mailFrom (futureRelease extension)
fastmail.masked_email(Fastmail-specific: create masked email address via MaskedEmail/set first)