forge
Clone forge-starter
plane: dataresource: EmailDeliveryC12rendered from forge v1.56.0 platform-model.json

send-email

Transactional email over SMTP — inline or a built-in template; every send persisted, redacted.

SendEmailPOST /capabilities/send-email
EmailDeliverythe Resource it produces
2 eventsEmailSent · EmailFailed

Ask your agent forge → send-email

you
Send the verification email to this user.
claude
forge → send-email Done — EmailDelivery created; I recorded EmailFailed.

From the terminal

$ forge email send --app hello --to … --template verify-email

HTTP :3718

POST /capabilities/send-email
Content-Type: application/json
x-forge-actor-type: builder
x-forge-actor-id: cli

{
  "app": "hello",
  "to": "user@example.com",
  "template": "verify-email"
}

Input fields 7

app
to
subject
html
text
template
data

Events ForgeEvent

EmailSent   resource_type: EmailDelivery
EmailFailed   resource_type: EmailDelivery

Resource GET /resources/EmailDelivery/:id

{
  "type": "EmailDelivery",
  "id": "res_01J…",
  "app_id": "app_hello",
  "status": "succeeded",
  "created_at": "2026-09-03T14:00:00Z"
}

Errors: see Reference → Errors. Find it in the playground