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

# Send HTML email

> Sends an email with raw HTML content and queues it for delivery. Accepts full HTML markup with optional plain text fallback. Requires `emails.email.sender` permission.



## OpenAPI

````yaml api-reference/emails.yaml post /html/send
openapi: 3.0.3
info:
  title: emails
  description: >-
    The Emails Service is responsible for sending emails on behalf of other
    services. It also manages and stores all email templates to ensure
    consistent and centralized communication formatting.
  version: 1.0.0
servers:
  - url: https://emails.platform.arb.inc
security: []
tags:
  - name: /
  - name: email
  - name: html
  - name: template
  - name: webhooks
paths:
  /html/send:
    post:
      tags:
        - html
      summary: Send HTML email
      description: >-
        Sends an email with raw HTML content and queues it for delivery. Accepts
        full HTML markup with optional plain text fallback. Requires
        `emails.email.sender` permission.
      operationId: sendHtmlEmail
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - expires
                - from
                - to
                - subject
                - html
                - idempotency_key
              properties:
                expires:
                  type: string
                  format: date-time
                  description: Expiration time for the email send request
                  example: '2025-08-15T10:30:00Z'
                from:
                  type: object
                  required:
                    - address
                  properties:
                    name:
                      type: string
                      description: Optional display name for sender
                      example: Arb Support
                    address:
                      type: string
                      format: email
                      description: Sender email address
                      example: support@arb.inc
                to:
                  type: array
                  minItems: 1
                  description: List of recipient email addresses
                  items:
                    type: object
                    required:
                      - address
                    properties:
                      name:
                        type: string
                        description: Optional display name for recipient
                        example: John Doe
                      address:
                        type: string
                        format: email
                        description: Recipient email address
                        example: user@example.com
                cc:
                  type: array
                  description: Optional list of CC recipients
                  items:
                    type: object
                    required:
                      - address
                    properties:
                      name:
                        type: string
                        description: Optional display name
                        example: Jane Smith
                      address:
                        type: string
                        format: email
                        description: CC email address
                        example: cc@example.com
                bcc:
                  type: array
                  description: Optional list of BCC recipients
                  items:
                    type: object
                    required:
                      - address
                    properties:
                      name:
                        type: string
                        description: Optional display name
                        example: Admin
                      address:
                        type: string
                        format: email
                        description: BCC email address
                        example: bcc@example.com
                replyTo:
                  type: object
                  description: Optional reply-to email address
                  properties:
                    name:
                      type: string
                      description: Optional display name
                      example: Support Team
                    address:
                      type: string
                      format: email
                      description: Reply-to email address
                      example: replyto@example.com
                subject:
                  type: string
                  description: Email subject line
                  example: Important Notice - Action Required
                html:
                  type: string
                  description: HTML content of the email
                  example: >-
                    <html><body><h1>Welcome</h1><p>Thank you for signing
                    up!</p></body></html>
                text:
                  type: string
                  description: Optional plain text version of the email
                  example: Welcome! Thank you for signing up!
                idempotency_key:
                  type: string
                  maxLength: 100
                  description: Unique key to prevent duplicate email sends
                  example: notice-2025-08-00292
      responses:
        '200':
          description: Email successfully queued for delivery
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: email queued for delivery
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````