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

# Add multiple SMTP email accounts

> **Bulk connect multiple email accounts via SMTP/IMAP**

Add multiple email accounts in a single request (max 100). Each account must have
valid SMTP/IMAP credentials.

## Important Notes

- Maximum 100 inboxes per request
- Connection validation runs in background
- Returns immediately with a job_id for tracking
- Poll the progress endpoint to check status

## Tracking Progress

Use the returned `job_id` to track progress:
```
GET /api/public/v1/sender-accounts/smtp/bulk/{job_id}/progress
```



## OpenAPI

````yaml /public_openapi.json post /api/public/v1/sender-accounts/smtp/bulk
openapi: 3.0.3
info:
  title: ColdSend Public API
  description: >-
    Programmatic access to ColdSend for managing cold email campaigns and sender
    accounts.
  version: 1.0.0
  contact:
    name: ColdSend Support
    email: support@coldsend.pro
    url: https://coldsend.pro
servers:
  - url: https://api.coldsend.pro
    description: Production
security:
  - ApiKeyAuth: []
paths:
  /api/public/v1/sender-accounts/smtp/bulk:
    post:
      tags:
        - Sender Accounts
      summary: Add multiple SMTP email accounts
      description: >-
        **Bulk connect multiple email accounts via SMTP/IMAP**


        Add multiple email accounts in a single request (max 100). Each account
        must have

        valid SMTP/IMAP credentials.


        ## Important Notes


        - Maximum 100 inboxes per request

        - Connection validation runs in background

        - Returns immediately with a job_id for tracking

        - Poll the progress endpoint to check status


        ## Tracking Progress


        Use the returned `job_id` to track progress:

        ```

        GET /api/public/v1/sender-accounts/smtp/bulk/{job_id}/progress

        ```
      operationId: create_smtp_inboxes_bulk_api_public_v1_sender_accounts_smtp_bulk_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SMTPInboxBulkCreateRequest'
        required: true
      responses:
        '202':
          description: Bulk SMTP inbox creation initiated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SMTPInboxBulkCreateResponse'
        '400':
          description: Invalid request data
        '401':
          description: Missing or invalid API key
        '403':
          description: Insufficient permissions - requires 'sender_accounts:write' scope
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    SMTPInboxBulkCreateRequest:
      properties:
        inboxes:
          items:
            $ref: '#/components/schemas/SMTPInboxBulkItem'
          type: array
          maxItems: 100
          minItems: 1
          title: Inboxes
          description: List of SMTP inboxes to create (max 100)
      type: object
      required:
        - inboxes
      title: SMTPInboxBulkCreateRequest
      description: Request for bulk creating SMTP inboxes.
    SMTPInboxBulkCreateResponse:
      properties:
        success:
          type: boolean
          title: Success
        message:
          type: string
          title: Message
        job_id:
          type: string
          nullable: true
          title: Job Id
          description: Job ID for tracking progress
        total:
          type: integer
          title: Total
          description: Total inboxes in request
        success_count:
          type: integer
          title: Success Count
          description: Number of successfully created inboxes
        failed_count:
          type: integer
          title: Failed Count
          description: Number of failed creations
        results:
          items:
            $ref: '#/components/schemas/SMTPInboxBulkResult'
          type: array
          title: Results
          description: Individual creation results
          default: []
      type: object
      required:
        - success
        - message
        - total
        - success_count
        - failed_count
      title: SMTPInboxBulkCreateResponse
      description: Response for bulk SMTP inbox creation.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SMTPInboxBulkItem:
      properties:
        email_address:
          type: string
          maxLength: 255
          minLength: 5
          title: Email Address
          description: Full email address
        display_name:
          type: string
          maxLength: 255
          minLength: 1
          title: Display Name
          description: Display name
        inbox_type:
          type: string
          title: Inbox Type
          description: 'Email provider type: GOOGLE_WORKSPACE, OUTLOOK_365, or CUSTOM_SMTP'
        daily_limit:
          type: integer
          minimum: 1
          title: Daily Limit
          description: Daily sending limit
          default: 100
        smtp_host:
          type: string
          title: Smtp Host
          description: SMTP server hostname
        smtp_port:
          type: integer
          maximum: 65535
          minimum: 1
          title: Smtp Port
          description: SMTP server port
        smtp_username:
          type: string
          title: Smtp Username
          description: SMTP username
        smtp_password:
          type: string
          title: Smtp Password
          description: SMTP password
        smtp_use_tls:
          type: boolean
          title: Smtp Use Tls
          description: Use TLS for SMTP
          default: true
        imap_host:
          type: string
          title: Imap Host
          description: IMAP server hostname
        imap_port:
          type: integer
          maximum: 65535
          minimum: 1
          title: Imap Port
          description: IMAP server port
        imap_username:
          type: string
          title: Imap Username
          description: IMAP username
        imap_password:
          type: string
          title: Imap Password
          description: IMAP password
        imap_use_ssl:
          type: boolean
          title: Imap Use Ssl
          description: Use SSL for IMAP
          default: true
      type: object
      required:
        - email_address
        - display_name
        - inbox_type
        - smtp_host
        - smtp_port
        - smtp_username
        - smtp_password
        - imap_host
        - imap_port
        - imap_username
        - imap_password
      title: SMTPInboxBulkItem
      description: Single item in bulk SMTP inbox creation.
    SMTPInboxBulkResult:
      properties:
        email_address:
          type: string
          title: Email Address
          description: Email address
        status:
          type: string
          title: Status
          description: Creation status (SUCCESS, FAILED)
        inbox_id:
          type: string
          format: uuid
          nullable: true
          title: Inbox Id
          description: Inbox ID if created
        error_message:
          type: string
          nullable: true
          title: Error Message
          description: Error message if failed
      type: object
      required:
        - email_address
        - status
      title: SMTPInboxBulkResult
      description: Result of single SMTP inbox creation in bulk operation.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key with format cs_live_xxx

````