Send a rendered email from a standalone runtime

Hosted fulfillment of the runtime EmailSender seam. Accepts a fully RENDERED message (no template strings) and dispatches it through the platform email path with the managed-send-from-domain gate evaluated against the authenticated account. Requires a Runtype API key with the FLOWS:EXECUTE scope. Requires an Enterprise plan: ineligible accounts receive 403 (code BYOC_PLAN_REQUIRED).

Authentication

AuthorizationBearer

API key or Clerk session token

Request

This endpoint expects an object.

subjectstringRequired

tolist of stringsRequired

attachmentslist of objectsOptional

bcclist of stringsOptional

cclist of stringsOptional

fromstringOptional

htmlstringOptional

managedLocalPartstringOptionalformat: "^[A-Za-z0-9._-]{1,64}$"

rawFromstringOptional

replyTostringOptional

textstringOptional

Response

Email dispatched

fromstring

idstring

tolist of strings

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

502

Bad Gateway Error

503

Service Unavailable Error

$	curl -X POST https://api.runtype.com/v1/runtime/email/send \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"subject": "Welcome to Runtype!",
>	"to": [
>	"jane.doe@example.com"
>	]
>	}'

1	{
2	"from": "no-reply@runtype.com",
3	"id": "a1b2c3d4-e5f6-7890-ab12-cdef34567890",
4	"to": [
5	"jane.doe@example.com"
6	]
7	}