---
title: "Send email"
method: POST
path: "/v1/connectors/gmail/messages/send"
tags: ["Connectors"]
---

# Send email

`POST /v1/connectors/gmail/messages/send`

## Request

- Base URL: `https://api.configure.dev`
- URL: `https://api.configure.dev/v1/connectors/gmail/messages/send`
- Auth: API key in header `X-API-Key` and HTTP bearer

Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.

## Headers

- `X-Agent` string

## Request body

- SendEmailRequest
  - `to` string, email, required
  - `subject` string, required
  - `body` string, required
  - `account` string: Connected Gmail account ID or email to send from. Omitted, the user's default Gmail account sends.

## Response `200`

Send result.

- SendEmailResponse
  - `sent` boolean, required: True only when Gmail returned a provider message id. False with delivery_status=unconfirmed when the provider completed the request without an id.
  - `retryable` boolean: False when delivery is unconfirmed because retrying could send a duplicate email.
  - `email` object, required
    - `to` string, email, required
    - `subject` string, required
    - `body_preview` string, required
    - `delivery_status` 'accepted' | 'unconfirmed', required: Accepted means Gmail returned a provider message id. Unconfirmed means the provider completed the request without an id; do not retry automatically.
    - `provider_message_id` string: Gmail message id returned by the provider. Present when delivery_status is accepted.
    - `from_account` object
      - `id` string
      - `email` string, email
    - `gmail_data` unknown
  - `message` string, required

---

[API](https://skmtc.dev/configure/apis/configure-http-api.md) · [All operations](https://skmtc.dev/configure/apis/configure-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/configure/apis/configure-http-api/revisions/ec760a9533d2?raw)