Validate Bulk Send CSV

post

https://www.signwell.com/api/v1/bulk_sends/validate_csv

Validates a Bulk Send CSV file before creating the Bulk Send. It will check the structure of the CSV and the data it contains, and return any errors found.

Body Params

template_ids

array of uuids

required

Specify one or more templates to generate a single blank CSV file that will contain available columns for your recipient data. The template_ids[] parameter is an array of template IDs (e.g.,/?template_ids[]=5a67dbd7-928a-4ea0-a7e2-e476a0eb045f&template_ids[]=d7315111-c671-4b15-8354-c9a19bbaefa0). Each ID should be a separate parameter in the query string.

template_ids*

bulk_send_csv

string

required

A RFC 4648 base64 string of the template CSV file to be validated. While 21 CFR Part 11 is enabled, every recipient needs a name: the CSV must carry a name column next to each placeholder email column (for example signer_name alongside signer_email), and each row must fill that name in wherever it carries the matching email, otherwise it returns a 422. A row that leaves both the email and the name blank sends nothing to that placeholder, so no name is needed there.

Responses

200successful

401unauthorized

422unprocessable entity

429rate limit exceeded