scrollport
Back to Email composition

Message Send

Gmail

Send a new message from a connected Gmail mailbox.

Capability
Email composition
Current price
$0.0050/call
Availability
Connected app
Last accepted verification

What this API does

Sends one structured Gmail message with optional bounded private attachments. Sending is externally visible and cannot be undone. It can optionally join an existing thread. Always one upstream request at $0.0050.

Agents select this operation with tool ID gmail.message-send, then inspect its current executable contract before a run.

Public input and output shape

Input

bodyobject · required

Bounded request body sent to the connected application.

Output

idstring

Returned id value.

labelIdsarray

Returned label ids value.

threadIdstring

Returned thread id value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "gmail.message-send",
  "input": {
    "body": {
      "email": {
        "to": [
          "hello@scrollport.com"
        ],
        "from": "alan.v20x@gmail.com",
        "text": "This test confirms ScrollPort can send email using the connected Gmail account.",
        "subject": "ScrollPort Gmail evidence test"
      }
    }
  }
}

Output

{
  "id": "18f0sentmessage456",
  "labelIds": [
    "SENT"
  ],
  "threadId": "18f0sentthread456"
}
Teaching errors and limitations
  • connection_required: This capability acts on your own Gmail mailbox, which isn't connected yet.Open connect_url, approve permission to send Gmail messages, then retry this run unchanged.
  • invalid_input: The structured email is missing its authorised sender, recipients, subject, or content.Provide body.email.from, to, subject, and text, html, or both. Attachments must use private ScrollPort artifact URLs.
Updated
23 August 2026

Use Message Send with Scrollport

Use Scrollport

Scrollport validates tools for connected apps and provides them on a pay-as-you-go basis so your agent can use accounts you already own without receiving sensitive API keys.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.