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

# Send a transactional email

> Sends one email from a marketing template to a single recipient, personalised with dataVariables. Intended for functional messages (password resets, receipts, confirmations): no unsubscribe link, no open or click tracking, and delivery does not depend on the recipient's subscription status.



## OpenAPI

````yaml /openapi.json post /marketing/transactional
openapi: 3.0.0
info:
  title: JetEmail API
  version: 1.0.0
  description: API documentation for JetEmail's transactional email service.
servers:
  - url: https://api.jetemail.com
    description: Production
security:
  - apiKeyAuth: []
tags:
  - name: Email
    description: Send transactional email
  - name: Outbound
    description: 'Outbound sending: keys, SMTP users, domains, logs, suppression'
  - name: Inbound
    description: Inbound routing, domains and forward destinations
  - name: Marketing
    description: >-
      Marketing suite: templates, audiences, contacts, broadcasts, themes,
      assets
externalDocs:
  description: Download OpenAPI Specification
  url: /openapi.json
paths:
  /marketing/transactional:
    post:
      tags:
        - Marketing
      summary: Send a transactional email
      description: >-
        Sends one email from a marketing template to a single recipient,
        personalised with dataVariables. Intended for functional messages
        (password resets, receipts, confirmations): no unsubscribe link, no open
        or click tracking, and delivery does not depend on the recipient's
        subscription status.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - transactionalId
                - email
              properties:
                transactionalId:
                  type: string
                  description: Template id to send
                email:
                  type: string
                  description: Recipient
                  example: jane@example.com
                dataVariables:
                  type: object
                  description: >-
                    Merge values for {{firstName}}, {{resetUrl}}, custom fields,
                    …
                  example:
                    firstName: Jane
                    resetUrl: https://app.example.com/reset/abc
                subject:
                  type: string
                  description: Overrides the template subject
                fromName:
                  type: string
                  description: Overrides the template sender name
                fromEmail:
                  type: string
                  description: >-
                    Overrides the template from address. Defaults to the
                    template sender if omitted. Must be on a verified sending
                    domain.
                replyTo:
                  type: string
                  description: Overrides the template reply-to
                addToAudience:
                  type: boolean
                  description: Upsert the recipient as a contact
                audienceIds:
                  type: array
                  items:
                    type: string
                  description: Audiences to add the contact to (with addToAudience)
                attachments:
                  type: array
                  description: >-
                    Optional file attachments, 25 MB total. Same shape as
                    /email: filename plus base64-encoded data.
                  items:
                    type: object
                    required:
                      - filename
                      - data
                    properties:
                      filename:
                        type: string
                        maxLength: 255
                      data:
                        type: string
                        description: Base64-encoded file content
      responses:
        '200':
          description: Sent
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  id:
                    type: string
                    description: Send id
                  messageId:
                    type: string
        '400':
          description: >-
            Missing/invalid email or transactionalId, or the message was
            rejected
        '402':
          description: Requires a paid marketing plan
        '404':
          description: Template not found
        '503':
          description: >-
            Temporarily unable to send; safe to retry (response includes
            retryable: true)
components:
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      description: API key for account management endpoints. Use your api_ prefixed token.

````