> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getoutbox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Email

> Send a single email to a contact. Either `html` or `text` is required. `subject`, `html`, and `text` all support `{{contact.*}}` / `{{company.*}}` variables. Pass `in_reply_to_message_log_id` (or `reply_to_thread_message_id`) to thread the email under a previous send. Opens and link clicks are always tracked.



## OpenAPI

````yaml POST /contact/send/email/
openapi: 3.1.0
info:
  title: Outbox AI API
  description: API for managing AI agents (chatbots and voicebots) on the Outbox platform
  version: 1.0.0
servers:
  - url: https://api.getoutbox.ai
security: []
paths:
  /contact/send/email/:
    post:
      tags:
        - contact
      summary: Send Email to Contact
      description: >-
        Send a single email to a contact. Either `html` or `text` is required.
        `subject`, `html`, and `text` all support `{{contact.*}}` /
        `{{company.*}}` variables. Pass `in_reply_to_message_log_id` (or
        `reply_to_thread_message_id`) to thread the email under a previous send.
        Opens and link clicks are always tracked.
      operationId: contact_send_email_create
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendEmailRequestRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/SendEmailRequestRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/SendEmailRequestRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                additionalProperties: {}
          description: Email sent. Body includes the message log + provider IDs.
        '400':
          description: >-
            Missing body, contact has DND or no email, or no `from_email`
            available.
        '404':
          description: Contact, sender identity, or referenced message log not found.
      security:
        - jwtAuth: []
        - {}
components:
  schemas:
    SendEmailRequestRequest:
      type: object
      properties:
        contact_id:
          type: string
          format: uuid
        subject:
          type: string
          description: Subject line. Supports variables.
        html:
          type: string
          description: HTML body. Supports variables.
        text:
          type: string
          description: >-
            Plaintext body. Supports variables. Used as a fallback if `html` is
            omitted.
        sender_identity_id:
          type: string
          format: uuid
          description: EmailSenderIdentity to send from. Defaults to the company default.
        reply_to:
          type: string
          format: email
          minLength: 1
          description: Override Reply-To address.
        in_reply_to_message_log_id:
          type: string
          format: uuid
          description: >-
            Thread under a previous EmailMessageLog. Auto-prefixes the subject
            with `Re:`.
        reply_to_thread_message_id:
          type: string
          format: uuid
          description: >-
            Conversation ThreadMessage id; must be an email message that has an
            `email_message_log_id` reference.
      required:
        - contact_id
  securitySchemes:
    jwtAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````