plane: dataresource: EmailDeliveryC25rendered from forge v1.56.0 platform-model.json

send-message

Send as the user through their connected provider — Gmail or Microsoft Graph — with a short-lived token from the connector vault.

SendMessagePOST /capabilities/send-message

EmailDeliverythe Resource it produces

2 eventsMessageSent · MessageFailed

Ask your agent forge → send-message

you

(your app calls this through POST /connect/:provider/send)

claude

forge → send-message Done — EmailDelivery created; I recorded MessageFailed.

From the terminal

# no CLI verb — HTTP only
curl -sS http://127.0.0.1:3718/capabilities/send-message \
 -H 'content-type: application/json' \
 -d '{"app":"hello","owner":"user_01","provider":"google","channel":"email","to":["dana@example.com"],"subject":"…","body":"…"}'

HTTP :3718

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

{
  "app": "hello",
  "owner": "user_01",
  "provider": "google",
  "channel": "email",
  "to": [
    "dana@example.com"
  ],
  "subject": "…",
  "body": "…"
}

Input fields 13

app
owner
provider
channel
to
cc
bcc
subject
body
content_type
in_reply_to
references
thread_ref

Events ForgeEvent

MessageSent   resource_type: EmailDelivery
MessageFailed   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