> ## Documentation Index
> Fetch the complete documentation index at: https://globale-enterprise.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Sending Bulk Emails

> Send CS (bulk) emails to multiple addressees in a single API call by providing order IDs, an email type, and optional placeholders.

<Note>
  Part of the [Sending Bulk Emails](/sending-bulk-emails) integration guide — see it for when and how to use this endpoint.
</Note>


## OpenAPI

````yaml api-reference/specs/sendbulkemails.yaml POST /emails
openapi: 3.0.3
info:
  title: SendBulkEmails (Merchant to Global-e)
  version: 1.0.0
  description: >-
    Emails can now be sent to multiple addresses by issuing an API call
    providing order IDs and the email message type. Additionally, placeholders
    can be added to the mail message to dynamically add details to the email
    message content without code changes.
  x-scaled-review: true
servers:
  - url: https://{globale_api_domain}
    variables:
      globale_api_domain:
        default: globale_api_domain
        description: The Global-e API domain (host placeholder; real value TBD).
security: []
tags:
  - name: SendBulkEmails (Merchant to Global-e)
    x-page-title: Sending Bulk Emails
  - name: 'Direction: Merchant → Global-e'
  - name: 'Domain: Orders'
paths:
  /emails:
    post:
      tags:
        - SendBulkEmails (Merchant to Global-e)
      summary: Sending Bulk Emails
      description: >-
        Emails can now be sent to multiple addresses by issuing an API call
        providing order IDs and the email message type. Additionally,
        placeholders can be added to the mail message to dynamically add details
        to the email message content without code changes.
      operationId: sendBulkEmails
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendBulkEmailsRequest'
            example:
              emailTypeName: Delayedfulfillment
              senderEmailAddress: globale@global-e.com
              reportToEmailAddress: zivido@gmail.com
              orderIds:
                - GE399999999GB
              placeholders:
                '{DelayReason}': TR_OverloadDelayReason
                '{DelayDaysCount}': '2'
      responses:
        '200':
          description: >-
            Processing is in progress. You will get an email after the process
            is complete.
          content:
            application/json:
              schema:
                type: string
              example: >-
                Processing is in progress. You will get an email after the
                process is complete.
        '400':
          description: >-
            Bad request. The following descriptions can be returned:

            - "At least one order ID must be provided."

            - "The sender's email address is incorrect."

            - "The SenderEmailAddress must be a valid email address."

            - "The EmailTypeName must be provided."

            - "Custom email type is not defined. Please contact Global-E
            support."

            - "The ReportToEmailAddress must be a valid email address."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInfo'
components:
  schemas:
    SendBulkEmailsRequest:
      type: object
      title: SendBulkEmailsRequest
      description: >-
        Request body for the Sending Bulk Emails API. Fields and mandatory
        markers are taken verbatim from the page's Parameters table.
      required:
        - emailTypeName
        - senderEmailAddress
        - reportToEmailAddress
        - orderIds
      properties:
        emailTypeName:
          type: string
          description: Specifies the name of the email type and its related HTML template.
        senderEmailAddress:
          type: string
          description: >-
            The mail address of the sender that the addressee sees. The default
            sender mail address is DoNotReply@globle.com or other mail specified
            by the merchant.
        reportToEmailAddress:
          type: string
          description: The merchant’s email address to receive the bulk sending report.
        orderIds:
          type: array
          description: The list of addressees, by their Order ID.
          items:
            type: string
        placeholders:
          type: array
          description: >-
            The placeholders and their values are defined in the Admin platform,
            with the prefix TR_
          items:
            $ref: '#/components/schemas/Placeholder'
    ErrorInfo:
      type: object
      title: ErrorInfo
      description: >-
        House-style error model. NOTE: this shape is NOT shown in the source for
        this endpoint — the page's Return Codes section lists only 400
        description strings. See review §2.
      properties:
        Code:
          type: string
        Error:
          type: string
        Description:
          type: string
    Placeholder:
      type: object
      title: Placeholder
      description: >-
        A placeholder and its value source. Fields inferred from the prose "Each
        Placeholder object contains: Placeholder Name; Value – A fixed value or
        text resource value" — no field-level table or type designations are
        documented. See review §2 (flag 5).
      properties:
        placeholderName:
          type: string
          description: Placeholder Name (field name inferred; not documented verbatim).
        value:
          type: string
          description: >-
            A fixed value or text resource value (field name inferred; not
            documented verbatim).

````