---
title: "Create Bulk Send"
method: POST
path: "/api/v1/bulk_sends"
tags: ["Bulk Send"]
---

# Create Bulk Send

`POST /api/v1/bulk_sends`

Creates a bulk send, and it validates the CSV file before creating the bulk send.

## Request body

- CreateBulkSendRequest
  - `template_ids` string[], required — Unique identifiers for a list of templates.
  - `bulk_send_csv` string, required — A RFC 4648 base64 string of the template CSV file to be validated.
  - `skip_row_errors` boolean — Whether to skip errors in the rows. Defaults to `false`.
  - `api_application_id` string, uuid — Unique identifier for API Application settings to use. API Applications are optional and mainly used when isolating OAuth apps or for more control over embedded API settings
  - `name` string — The name of the Bulk Send. Will be used as the document name for each of the documents.
  - `subject` string — Email subject for the signature request that recipients will see. Defaults to the default system subject or a template subject.
  - `message` string — Email message for the signature request that recipients will see. Defaults to the default system message or a template message.
  - `apply_signing_order` boolean — When set to `true` recipients will sign one at a time in the order of the `recipients` collection of this request.
  - `custom_requester_name` string — Sets the custom requester name for the document. When set, this is the name used for all email communications, signing notifications, and in the audit file.
  - `custom_requester_email` string, email — Sets the custom requester email for the document. When set, this is the email used for all email communications, signing notifications, and in the audit file.

## Response `201`

successful

- BulkSendCreateResponse — Bulk send creation response
  - `id` string, uuid, required
  - `template_ids` string[], required
  - `api_application_id` string, uuid, nullable
  - `documents_count` integer, required
  - `created_at` string, date-time, required
  - `user_id` string, uuid, nullable
  - `status` string, required

## Other responses

- `401` — unauthorized
- `422` — unprocessable entity
- `429` — rate limit exceeded

---

[API](https://skmtc.net/signwell/apis/signwell-developer-api.md) · [All operations](https://skmtc.net/signwell/apis/signwell-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signwell/signwell-developer-api/revisions/debef5796b62/schema)