# Initiate a new bulk email

POST https://api.close.com/api/v1/bulk_action/email/
Content-Type: application/json

`contact_preference` can be set to `lead` (only email the primary/first contact email of the lead) or `contact` (email the first contact email of each contact of the lead).

Reference: https://developer.close.com/api/resources/bulk-actions/email/create

## OpenAPI Specification

```yaml
openapi: 3.1.0
info:
  title: Close API
  version: 1.0.0
paths:
  /bulk_action/email/:
    post:
      operationId: create
      summary: Initiate a new bulk email
      description: >-
        `contact_preference` can be set to `lead` (only email the primary/first
        contact email of the lead) or `contact` (email the first contact email
        of each contact of the lead).
      tags:
        - subpackage_bulkActionsEmail
      parameters:
        - name: Authorization
          in: header
          description: Basic authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkEmailAction'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                description: Any type
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                description: Any type
        '404':
          description: Not found
          content:
            application/json:
              schema:
                description: Any type
      requestBody:
        content:
          application/json:
            schema:
              description: Any type
servers:
  - url: https://api.close.com/api/v1
components:
  schemas:
    BulkEmailContactPreference:
      type: string
      enum:
        - lead
        - contact
        - all
      title: BulkEmailContactPreference
    BulkActionStatus:
      type: string
      enum:
        - created
        - loading
        - processing
        - done
        - paused
        - resuming
        - error
      title: BulkActionStatus
    BulkEmailAction:
      type: object
      properties:
        contact_preference:
          oneOf:
            - $ref: '#/components/schemas/BulkEmailContactPreference'
            - type: 'null'
        created_by:
          type:
            - string
            - 'null'
        date_created:
          type:
            - string
            - 'null'
          format: date-time
        date_updated:
          type:
            - string
            - 'null'
          format: date-time
        email_account_id:
          type:
            - string
            - 'null'
        id:
          type: string
        n_leads:
          type:
            - integer
            - 'null'
        n_leads_processed:
          type: integer
        n_objects:
          type:
            - integer
            - 'null'
        n_objects_processed:
          type: integer
        organization_id:
          type: string
        query:
          type:
            - string
            - 'null'
        results_limit:
          type:
            - integer
            - 'null'
        s_query:
          type: object
          additionalProperties:
            description: Any type
        send_done_email:
          type: boolean
        sender:
          type:
            - string
            - 'null'
        sort:
          type: array
          items:
            type: object
            additionalProperties:
              description: Any type
        status:
          oneOf:
            - $ref: '#/components/schemas/BulkActionStatus'
            - type: 'null'
        template_id:
          type:
            - string
            - 'null'
        updated_by:
          type:
            - string
            - 'null'
      required:
        - contact_preference
        - created_by
        - date_created
        - date_updated
        - email_account_id
        - id
        - n_leads
        - n_leads_processed
        - n_objects
        - n_objects_processed
        - organization_id
        - query
        - results_limit
        - s_query
        - send_done_email
        - sender
        - sort
        - status
        - template_id
        - updated_by
      title: BulkEmailAction
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: basic
    OAuth2:
      type: http
      scheme: bearer

```