POST /v1/signature/envelopes/bulk
const url = 'https://api.asap.cool/v1/signature/envelopes/bulk';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"cc_recipients":["example"],"expires_at":"example","labels":["example"],"message":"example","recipients":[{"email":"example","full_name":"example","phone":"example"}],"reminder_interval_hours":1,"reminder_max_count":1,"source_document_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","subject":"example","template_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","verification_method":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.asap.cool/v1/signature/envelopes/bulk \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "cc_recipients": [ "example" ], "expires_at": "example", "labels": [ "example" ], "message": "example", "recipients": [ { "email": "example", "full_name": "example", "phone": "example" } ], "reminder_interval_hours": 1, "reminder_max_count": 1, "source_document_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "subject": "example", "template_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "verification_method": "example" }'Authorizations
Section intitulée « Authorizations »Request Body required
Section intitulée « Request Body required »Body of POST /v1/signature/envelopes/bulk. org_id is never accepted.
object
Addresses copied on every completion notification (Cc; defaults to empty).
When the envelopes (and their tokens) expire (RFC3339), applied to all.
Free-form labels applied to every envelope (defaults to empty).
Optional request-email message applied to every envelope.
Recipients (1..=100). Each yields one mono-signer envelope.
One recipient of a bulk send: the lone signer of a generated envelope.
object
Signer email (required).
Signer full name (required).
Phone (E.164) for SMS OTP; required when verification_method is
sms_otp.
Delay between two automatic reminders, in hours (omitted = default cadence).
How many automatic reminders may fire (omitted = a single reminder).
The shared standalone document every envelope wraps (org-scoped UUID).
Optional request-email subject applied to every envelope.
Optional template (UUID) whose presets pre-fill any omitted
subject/message/labels/cc_recipients on every envelope.
Identity-verification method applied to every signer: email_otp
(default) or sms_otp.
Example generated
{ "cc_recipients": [ "example" ], "expires_at": "example", "labels": [ "example" ], "message": "example", "recipients": [ { "email": "example", "full_name": "example", "phone": "example" } ], "reminder_interval_hours": 1, "reminder_max_count": 1, "source_document_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "subject": "example", "template_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "verification_method": "example"}Responses
Section intitulée « Responses »Per-recipient results with aggregate counts (partial success allowed).
Body of a bulk send: one result per recipient plus aggregate counts.
object
How many recipients failed (captured, non-fatal).
One entry per recipient, in request order.
Outcome for one recipient of a bulk send.
object
The recipient’s email (echoed for correlation).
The envelope id when one was created. Present on success, and also on a
post-creation send failure (the draft can be retried); null only when
creation itself failed (e.g. validation).
A human-readable error code/message on failure; null on success.
How many recipients were sent successfully.
Example generated
{ "failed_count": 1, "results": [ { "email": "example", "envelope_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "error": "example" } ], "sent_count": 1}No active org.
Generic error body returned by API handlers when they fail. code is a
stable machine-readable token; message is human-friendly and meant for
surfacing to end users.
object
Stable machine token (e.g. invalid_credentials).
Offending request field for validation errors, when known.
Human-readable message.
Example generated
{ "code": "example", "field": "example", "message": "example"}Missing signature:write scope.
Generic error body returned by API handlers when they fail. code is a
stable machine-readable token; message is human-friendly and meant for
surfacing to end users.
object
Stable machine token (e.g. invalid_credentials).
Offending request field for validation errors, when known.
Human-readable message.
Example generated
{ "code": "example", "field": "example", "message": "example"}Empty or oversized recipient list, or an invalid shared field.
Generic error body returned by API handlers when they fail. code is a
stable machine-readable token; message is human-friendly and meant for
surfacing to end users.
object
Stable machine token (e.g. invalid_credentials).
Offending request field for validation errors, when known.
Human-readable message.
Example generated
{ "code": "example", "field": "example", "message": "example"}