> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL. > > Documentation indexes by section: > - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt > - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt > - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt > - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt > > Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth > Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks > > OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json > MCP server: https://docusign.docs.buildwithfern.com/_mcp/server # BulkSend Resource You can use bulk send lists send documents to a large number of recipients on a recurring basis. You can use a bulk send list to send up to 1,000 copies at a time. After you create a bulk send list, it persists and can be reused and edited any number of times. You can customize individual copies of the envelope. For example, you can customize the email notification and language and add personalized notes. ### Requirements and limitations * Bulk send must be enabled for your account. To enable this feature, contact your Account Manager or Business Development representative. * You can include up to 1,000 bulk recipients in each request. * When you send an envelope with bulk recipients, envelopes are added to a bulk recipient queue and sent in a metered fashion. An account can have a total of 2,000 total envelopes in the queue at a time. If you reach this limit, you will get an error message. Wait and resend the envelope at a later time. If you hit queue limits often, contact your Account Manager to see about modifying the queue limits for your account. ### Related topics * [Bulk sending envelopes](/docs/esign-rest-api/esign101/concepts/envelopes/bulk-send) concept guide * [How to bulk send envelopes](/docs/esign-rest-api/how-to/bulk-send-envelopes) ## Methods supported | Method | Description | | ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | [createBulkSendList](/docs/esign-rest-api/reference/bulkenvelopes/bulksend/createbulksendlist) | POST `/restapi/v2.1/accounts/{accountId}/bulk_send_lists` Creates a bulk send list. | | [createBulkSendRequest](/docs/esign-rest-api/reference/bulkenvelopes/bulksend/createbulksendrequest) | POST `/restapi/v2.1/accounts/{accountId}/bulk_send_lists/{bulkSendListId}/send` Creates a bulk send request. | | [createBulkSendTestRequest](/docs/esign-rest-api/reference/bulkenvelopes/bulksend/createbulksendtestrequest) | POST `/restapi/v2.1/accounts/{accountId}/bulk_send_lists/{bulkSendListId}/test` Creates a bulk send test. | | [deleteBulkSendList](/docs/esign-rest-api/reference/bulkenvelopes/bulksend/deletebulksendlist) | DEL `/restapi/v2.1/accounts/{accountId}/bulk_send_lists/{bulkSendListId}` Deletes a bulk send list. | | [getBulkSendBatchEnvelopes](/docs/esign-rest-api/reference/bulkenvelopes/bulksend/getbulksendbatchenvelopes) | GET `/restapi/v2.1/accounts/{accountId}/bulk_send_batch/{bulkSendBatchId}/envelopes` Gets envelopes from a specific bulk send batch. | | [getBulkSendBatches](/docs/esign-rest-api/reference/bulkenvelopes/bulksend/getbulksendbatches) | GET `/restapi/v2.1/accounts/{accountId}/bulk_send_batch` Returns a list of bulk send batch summaries. | | [getBulkSendBatchStatus](/docs/esign-rest-api/reference/bulkenvelopes/bulksend/getbulksendbatchstatus) | GET `/restapi/v2.1/accounts/{accountId}/bulk_send_batch/{bulkSendBatchId}` Gets the status of a specific bulk send batch. | | [getBulkSendList](/docs/esign-rest-api/reference/bulkenvelopes/bulksend/getbulksendlist) | GET `/restapi/v2.1/accounts/{accountId}/bulk_send_lists/{bulkSendListId}` Gets a specific bulk send list. | | [getBulkSendLists](/docs/esign-rest-api/reference/bulkenvelopes/bulksend/getbulksendlists) | GET `/restapi/v2.1/accounts/{accountId}/bulk_send_lists` Gets bulk send lists. | | [updateBulkSendBatchAction](/docs/esign-rest-api/reference/bulkenvelopes/bulksend/updatebulksendbatchaction) | PUT `/restapi/v2.1/accounts/{accountId}/bulk_send_batch/{bulkSendBatchId}/{bulkAction}` Applies a bulk action to all envelopes from a specified bulk send. | | [updateBulkSendBatchStatus](/docs/esign-rest-api/reference/bulkenvelopes/bulksend/updatebulksendbatchstatus) | PUT `/restapi/v2.1/accounts/{accountId}/bulk_send_batch/{bulkSendBatchId}` Updates the name of a bulk send batch. | | [updateBulkSendList](/docs/esign-rest-api/reference/bulkenvelopes/bulksend/updatebulksendlist) | PUT `/restapi/v2.1/accounts/{accountId}/bulk_send_lists/{bulkSendListId}` Updates a bulk send list. | ## BulkSend properties | Property | Type | Description | | ------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `bulkCopies` | array | An array of `bulkCopy` objects. Each object represents an instance or copy of an envelope and contains details such as the recipient, custom fields, tabs, and other information. | | `listId` | string | The GUID of the bulk send list. This property is created after you post a new bulk send list. | | `name` | string | The name of the bulk send list. | ## API Docs - BulkSend [Create bulk send list](https://developers.docusign.com/docs/esign-rest-api/reference/bulkenvelopes/bulksend/createbulksendlist.md) - BulkSend [Create bulk send request](https://developers.docusign.com/docs/esign-rest-api/reference/bulkenvelopes/bulksend/createbulksendrequest.md) - BulkSend [Create bulk send test](https://developers.docusign.com/docs/esign-rest-api/reference/bulkenvelopes/bulksend/createbulksendtestrequest.md) - BulkSend [Delete bulk send list](https://developers.docusign.com/docs/esign-rest-api/reference/bulkenvelopes/bulksend/deletebulksendlist.md) - BulkSend [Get envelopes from bulk send batch](https://developers.docusign.com/docs/esign-rest-api/reference/bulkenvelopes/bulksend/getbulksendbatchenvelopes.md) - BulkSend [List bulk send batch summaries](https://developers.docusign.com/docs/esign-rest-api/reference/bulkenvelopes/bulksend/getbulksendbatches.md) - BulkSend [Get status of bulk send batch](https://developers.docusign.com/docs/esign-rest-api/reference/bulkenvelopes/bulksend/getbulksendbatchstatus.md) - BulkSend [Get bulk send list](https://developers.docusign.com/docs/esign-rest-api/reference/bulkenvelopes/bulksend/getbulksendlist.md) - BulkSend [Get bulk send lists](https://developers.docusign.com/docs/esign-rest-api/reference/bulkenvelopes/bulksend/getbulksendlists.md) - BulkSend [Apply bulk action to all envelopes from bulk send](https://developers.docusign.com/docs/esign-rest-api/reference/bulkenvelopes/bulksend/updatebulksendbatchaction.md) - BulkSend [Update name of bulk send batch](https://developers.docusign.com/docs/esign-rest-api/reference/bulkenvelopes/bulksend/updatebulksendbatchstatus.md) - BulkSend [Update bulk send list](https://developers.docusign.com/docs/esign-rest-api/reference/bulkenvelopes/bulksend/updatebulksendlist.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://developers.docusign.com/openapi.json) - [OpenAPI YAML](https://developers.docusign.com/openapi.yaml)