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

# Send bulk email (batch send to multiple recipients)

> Queue a bulk email send to multiple recipients. The email will be processed in the background and sent to all recipients with the same content. All sends are tracked individually in the email log.



## OpenAPI

````yaml https://api.sapt.ai/openapi.json post /emails/bulk
openapi: 3.1.0
info:
  title: Sapt Platform API
  version: 1.0.0
  description: >-
    API for Sapt platform - project management, authentication, and email
    services
servers:
  - url: https://api.sapt.ai
    description: Production
  - url: http://localhost:8787
    description: Local development
security: []
tags:
  - name: Accounts
    description: >-
      The social accounts connected to a project. Start here — the `id` of an
      account is the `socialAccountId` that every posting, scheduling and
      analytics call takes.
  - name: Actions
  - name: Ads
  - name: Agents
  - name: Analytics
    description: >-
      Account- and post-level organic performance for connected Instagram and
      Facebook accounts.
  - name: Assets
  - name: Auth
  - name: CMS
  - name: CRM
  - name: Calendar
  - name: Comments
    description: >-
      Read, reply to, hide and delete comments on published Instagram and
      Facebook posts.
  - name: Content Calendar
    description: >-
      Create, schedule, update and publish organic posts, and stage the media
      they carry. Publishing a post whose status is `failed` retries it.
  - name: Contracts
  - name: Conversions
    description: >-
      Meta server-side Conversions API (CAPI): discover pixels, connect a pixel
      + CAPI token, and send deduped server-side conversions.
  - name: Dashboard Sidebar
  - name: Emails
  - name: Engagement
    description: >-
      Act as the Page or account on published posts: comment, like, unlike, and
      delete a published post.
  - name: Geo
  - name: Google Ads
  - name: Google Analytics
  - name: Google Business
  - name: Integrations
    description: >-
      Connect third-party providers (Meta, Gmail, Google Business Profile, …).
      List providers, mint OAuth connect links, and poll connection status.
  - name: Invitations
  - name: Memory
  - name: OAuth Clients
  - name: Project Roles
  - name: Project Templates
  - name: Projects
  - name: Schedules
  - name: Service Accounts
  - name: Socials
    description: >-
      Organic social: the connected accounts, the content calendar, media
      staging, publishing, comments and engagement across Instagram, Facebook,
      TikTok, YouTube and Google Business Profile.
  - name: Team
  - name: Users
  - name: Web Analytics
  - name: Workflows
paths:
  /emails/bulk:
    post:
      tags:
        - Emails
      summary: Send bulk email (batch send to multiple recipients)
      description: >-
        Queue a bulk email send to multiple recipients. The email will be
        processed in the background and sent to all recipients with the same
        content. All sends are tracked individually in the email log.
      operationId: sendBulk
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                recipients:
                  type: array
                  items:
                    type: object
                    properties:
                      email:
                        type: string
                        format: email
                      name:
                        type: string
                    required:
                      - email
                  minItems: 1
                  maxItems: 10000
                  example:
                    - email: user1@example.com
                      name: John Doe
                    - email: user2@example.com
                      name: Jane Smith
                  description: List of recipients (1-10,000)
                subject:
                  type: string
                  minLength: 1
                  maxLength: 200
                  example: Important Update
                  description: Email subject line
                html:
                  type: string
                  minLength: 1
                  maxLength: 500000
                  example: >-
                    <html><body><h1>Update</h1><p>Important
                    information...</p></body></html>
                  description: HTML email content (max 500KB)
                text:
                  type: string
                  maxLength: 100000
                  example: 'Update: Important information...'
                  description: Plain text fallback (optional)
                name:
                  type: string
                  maxLength: 200
                  example: Monthly Newsletter - November 2024
                  description: Optional description/name for this bulk send
                metadata:
                  type: object
                  additionalProperties: {}
                  example:
                    campaign: november-newsletter
                  description: Additional metadata
              required:
                - recipients
                - subject
                - html
      responses:
        '200':
          description: Bulk send queued successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  bulkSendId:
                    type: string
                  status:
                    type: string
                  totalRecipients:
                    type: number
                required:
                  - success
                  - bulkSendId
                  - status
                  - totalRecipients
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message
                  code:
                    type: string
                    description: Error code for programmatic handling
                required:
                  - message
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        JWT token obtained from /api/auth/token endpoint. Token is verified
        using JWKS and must include a valid user identifier.

````