> ## 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 ColdSend native inboxes > **Bulk create ColdSend managed email inboxes** Create multiple email inboxes in a single request (max 100). Useful for setting up multiple sending addresses for different purposes. ## Important Notes - All inboxes must be on the same domain - **This is an async operation** — inboxes are created via background tasks - The response includes a ``job_id`` and ``progress_url`` for tracking - Poll ``GET /sender-accounts/coldsend-native/bulk/{job_id}/progress`` for real-time results - The initial response will always have ``success_count: 0``, ``results: []`` - Maximum of 100 inboxes per request ## OpenAPI ````yaml /public_openapi.json post /api/public/v1/sender-accounts/coldsend-native/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/coldsend-native/bulk: post: tags: - Sender Accounts summary: Add multiple ColdSend native inboxes description: >- **Bulk create ColdSend managed email inboxes** Create multiple email inboxes in a single request (max 100). Useful for setting up multiple sending addresses for different purposes. ## Important Notes - All inboxes must be on the same domain - **This is an async operation** — inboxes are created via background tasks - The response includes a ``job_id`` and ``progress_url`` for tracking - Poll ``GET /sender-accounts/coldsend-native/bulk/{job_id}/progress`` for real-time results - The initial response will always have ``success_count: 0``, ``results: []`` - Maximum of 100 inboxes per request operationId: >- create_coldsend_inboxes_bulk_api_public_v1_sender_accounts_coldsend_native_bulk_post requestBody: content: application/json: schema: $ref: '#/components/schemas/ColdSendInboxBulkCreateRequest' required: true responses: '201': description: Bulk creation initiated successfully content: application/json: schema: $ref: '#/components/schemas/ColdSendInboxBulkCreateResponse' '400': description: Invalid request data '401': description: Missing or invalid API key '403': description: Insufficient permissions - requires 'sender_accounts:write' scope '404': description: Domain not found '409': description: Domain at capacity or other conflict '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: ColdSendInboxBulkCreateRequest: properties: domain_id: type: string format: uuid title: Domain Id description: Domain ID where all inboxes will be created inboxes: items: $ref: '#/components/schemas/ColdSendInboxBulkItem' type: array maxItems: 100 minItems: 1 title: Inboxes description: List of inboxes to create (max 100) type: object required: - domain_id - inboxes title: ColdSendInboxBulkCreateRequest description: Request for bulk creating ColdSend native inboxes. ColdSendInboxBulkCreateResponse: properties: success: type: boolean title: Success message: type: string title: Message job_id: type: string format: uuid title: Job Id description: Unique job ID for tracking creation progress domain_id: type: string format: uuid title: Domain Id description: Domain ID domain_name: type: string title: Domain Name description: Domain name total: type: integer title: Total description: Total inboxes in request progress_url: type: string title: Progress Url description: URL to poll for creation progress success_count: type: integer title: Success Count description: Always 0 in initial response — poll progress endpoint for results default: 0 failed_count: type: integer title: Failed Count description: Always 0 in initial response — poll progress endpoint for results default: 0 skipped_count: type: integer title: Skipped Count description: Always 0 in initial response — poll progress endpoint for results default: 0 results: items: $ref: '#/components/schemas/ColdSendInboxBulkResult' type: array title: Results description: >- Always empty in initial response — poll progress endpoint for per-inbox results type: object required: - success - message - job_id - domain_id - domain_name - total - progress_url title: ColdSendInboxBulkCreateResponse description: |- Response for bulk ColdSend inbox creation. This is an async operation. Inboxes are created via background tasks. The ``success_count``, ``failed_count``, and ``results`` fields will always be zero/empty in this response — poll the progress endpoint to get real-time results. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ColdSendInboxBulkItem: properties: email_prefix: type: string maxLength: 64 minLength: 1 title: Email Prefix description: Email prefix for this inbox display_name: type: string maxLength: 255 minLength: 1 title: Display Name description: Display name for this inbox type: object required: - email_prefix - display_name title: ColdSendInboxBulkItem description: Single item in bulk ColdSend inbox creation. ColdSendInboxBulkResult: properties: email_prefix: type: string title: Email Prefix description: Email prefix email_address: type: string nullable: true title: Email Address description: Full email address if created display_name: type: string title: Display Name description: Display name status: type: string title: Status description: Creation status (SUCCESS, FAILED, SKIPPED) 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_prefix - display_name - status title: ColdSendInboxBulkResult description: Result of single ColdSend 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 ````