> ## 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.

# Create / send / schedule a broadcast

> status="draft" saves without sending. status="sending" dispatches now, or holds until scheduledAt if provided. Dispatch resolves recipients from the audience (subscribed contacts only) and snapshots the template, so later template edits do not affect the send. Marketing sends are metered separately from Outbound (free tier 3000/month).



## OpenAPI

````yaml /openapi.json post /marketing/broadcasts
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/broadcasts:
    post:
      tags:
        - Marketing
      summary: Create / send / schedule a broadcast
      description: >-
        status="draft" saves without sending. status="sending" dispatches now,
        or holds until scheduledAt if provided. Dispatch resolves recipients
        from the audience (subscribed contacts only) and snapshots the template,
        so later template edits do not affect the send. Marketing sends are
        metered separately from Outbound (free tier 3000/month).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - name
              properties:
                name:
                  type: string
                templateId:
                  type: string
                audienceId:
                  type: string
                  description: Target audience id (required to send)
                fromName:
                  type: string
                fromEmail:
                  type: string
                subject:
                  type: string
                status:
                  type: string
                  enum:
                    - draft
                    - sending
                scheduledAt:
                  type: string
                  format: date-time
                  description: >-
                    ISO timestamp; when set with status=sending the broadcast is
                    scheduled
      responses:
        '200':
          description: Created/dispatched
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  id:
                    type: string
                  recipientCount:
                    type: integer
components:
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      description: API key for account management endpoints. Use your api_ prefixed token.

````