Industries
Collect Volunteer Waivers and Agreements
Send a branded volunteer waiver that the volunteer and a guardian sign in any order, and route completion to your volunteer database with topics and metadata.
A nonprofit signs up volunteers for every event, and minors need a guardian signature too. Paper waivers get lost and coordinators spend the morning chasing them. Send one waiver to both people at once. Each signs when they have a minute, and the emails carry your organization’s colors.
Envelope shape
- One PDF document, two signers. The volunteer and the guardian are both
signerrecipients. The volunteer has aninitialsplace for the risk acknowledgement and asignatureplace. The guardian has asignatureplace. See Initials and Signature. - Places by fixed position. The
fixed_positionsarray pins each place key to a page,topandleft. See Use fixed positions. - Branding.
branding.accent_colorsets the color of the ceremony and emails.branding.email.footerandlogo_positionadjust the email. See Customize branding. - Metadata and topics.
metadata.event_idties the envelope to the event. Thevolunteersandwaiverstopics let you filter envelopes. See Organize with topics and metadata.
Routing
The envelope uses parallel routing. Both signers get their invitation as soon as the envelope starts, and either can sign first. Parallel routing accepts only signing recipients, so a coordinator who must review the waiver first needs sequential routing instead. See Parallel signing.
Webhooks to listen for
recipient.completed: fires once for the volunteer and once for the guardian. Readrecipient_keyto record which of the two has signed.envelope.completed: both have signed. Mark the volunteer as cleared for the event.deliverable.generated: the signed waiver and audit log are ready. Download them and attach them to the volunteer record.
Set up the endpoint as shown in Set up webhooks.
Compliance notes
This is general information, not legal advice. Whether a waiver signed by a guardian on behalf of a minor is enforceable depends on your jurisdiction and the wording of the waiver, so have counsel review your document and process. Keep sensitive personal data out of metadata, which appears in webhook payloads.
POST /v1/envelopes HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
{
"title": "Volunteer Waiver (sample)",
"message": "Thank you for volunteering. Please review and sign the waiver.",
"routing": "parallel",
"metadata": {
"event_id": "evt_2027_spring_cleanup"
},
"topics": [
"volunteers",
"waivers"
],
"branding": {
"accent_color": "#2e7d32",
"email": {
"footer": "Acme Corp Foundation (synthetic example)",
"logo_position": "center"
}
},
"documents": [
{
"key": "waiver",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "volunteer_initials",
"page": 1,
"top": 250,
"left": 72
},
{
"place_key": "volunteer_signature",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "guardian_signature",
"page": 1,
"top": 186,
"left": 220
}
],
"places": [
{
"key": "volunteer_initials",
"type": "initials",
"recipient_key": "volunteer",
"height": 30
},
{
"key": "volunteer_signature",
"type": "signature",
"recipient_key": "volunteer"
},
{
"key": "guardian_signature",
"type": "signature",
"recipient_key": "guardian"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "volunteer",
"name": "Maria Garcia",
"email": "maria.garcia@example.com"
},
{
"type": "signer",
"key": "guardian",
"name": "Jane Doe",
"email": "jane.doe@example.com"
}
]
}npx signatureapi envelopes create --body - <<'EOF'
{
"title": "Volunteer Waiver (sample)",
"message": "Thank you for volunteering. Please review and sign the waiver.",
"routing": "parallel",
"metadata": {
"event_id": "evt_2027_spring_cleanup"
},
"topics": [
"volunteers",
"waivers"
],
"branding": {
"accent_color": "#2e7d32",
"email": {
"footer": "Acme Corp Foundation (synthetic example)",
"logo_position": "center"
}
},
"documents": [
{
"key": "waiver",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "volunteer_initials",
"page": 1,
"top": 250,
"left": 72
},
{
"place_key": "volunteer_signature",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "guardian_signature",
"page": 1,
"top": 186,
"left": 220
}
],
"places": [
{
"key": "volunteer_initials",
"type": "initials",
"recipient_key": "volunteer",
"height": 30
},
{
"key": "volunteer_signature",
"type": "signature",
"recipient_key": "volunteer"
},
{
"key": "guardian_signature",
"type": "signature",
"recipient_key": "guardian"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "volunteer",
"name": "Maria Garcia",
"email": "maria.garcia@example.com"
},
{
"type": "signer",
"key": "guardian",
"name": "Jane Doe",
"email": "jane.doe@example.com"
}
]
}
EOF{
"name": "create_envelope",
"arguments": {
"title": "Volunteer Waiver (sample)",
"message": "Thank you for volunteering. Please review and sign the waiver.",
"routing": "parallel",
"metadata": {
"event_id": "evt_2027_spring_cleanup"
},
"topics": [
"volunteers",
"waivers"
],
"branding": {
"accent_color": "#2e7d32",
"email": {
"footer": "Acme Corp Foundation (synthetic example)",
"logo_position": "center"
}
},
"documents": [
{
"key": "waiver",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "volunteer_initials",
"page": 1,
"top": 250,
"left": 72
},
{
"place_key": "volunteer_signature",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "guardian_signature",
"page": 1,
"top": 186,
"left": 220
}
],
"places": [
{
"key": "volunteer_initials",
"type": "initials",
"recipient_key": "volunteer",
"height": 30
},
{
"key": "volunteer_signature",
"type": "signature",
"recipient_key": "volunteer"
},
{
"key": "guardian_signature",
"type": "signature",
"recipient_key": "guardian"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "volunteer",
"name": "Maria Garcia",
"email": "maria.garcia@example.com"
},
{
"type": "signer",
"key": "guardian",
"name": "Jane Doe",
"email": "jane.doe@example.com"
}
]
}
}{
"id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"title": "Volunteer Waiver (sample)",
"label": null,
"message": "Thank you for volunteering. Please review and sign the waiver.",
"status": "processing",
"attestation": "none",
"language": "en",
"mode": "test",
"routing": "parallel",
"timezone": "UTC",
"timestamp_format": "MM/DD/YYYY HH:mm:ss",
"snapshot_url": null,
"branding": {
"logo": null,
"accent_color": "#2e7d32",
"email": {
"footer": "Acme Corp Foundation (synthetic example)",
"logo_position": "center",
"from": "noreply@signatureapi.com"
}
},
"deliverable": {
"id": "del_HVl3Nj7XzTzX7jN3lVH5vn",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"name": null,
"status": "pending",
"type": "standard",
"url": null,
"password": null,
"created_at": "2026-11-02T14:03:11.000Z",
"generated_at": null,
"timezone": "UTC",
"language": "en",
"timestamp_format": "MM/DD/YYYY HH:mm:ss",
"included_documents": [
"waiver"
]
},
"metadata": {
"event_id": "evt_2027_spring_cleanup"
},
"sender": {
"name": "Acme Corp Legal",
"email": "legal@acme.example",
"organization": "Acme Corp"
},
"captures": {},
"documents": [
{
"id": "doc_HVl3Nj7XzTzX7jN3lVH5vn",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"key": "waiver",
"title": null,
"page_count": 1,
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"page": 1,
"top": 250,
"left": 72,
"place_key": "volunteer_initials"
},
{
"page": 1,
"top": 172,
"left": 210,
"place_key": "volunteer_signature"
},
{
"page": 1,
"top": 186,
"left": 220,
"place_key": "guardian_signature"
}
],
"places": [
{
"key": "volunteer_initials",
"type": "initials",
"recipient_key": "volunteer",
"height": 30
},
{
"key": "volunteer_signature",
"type": "signature",
"recipient_key": "volunteer",
"height": 60
},
{
"key": "guardian_signature",
"type": "signature",
"recipient_key": "guardian",
"height": 60
}
]
}
],
"recipients": [
{
"id": "re_HVl3Nj7XzTzX7jN3lVH5vn",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "signer",
"key": "volunteer",
"email": "maria.garcia@example.com",
"name": "Maria Garcia",
"ceremony": {
"authentication": [
{
"type": "email_link",
"subject_override": null,
"message_override": null
}
],
"embeddable_in": [],
"redirect_url": null,
"redirect_delay": 3,
"url": null,
"url_variant": "standard"
},
"ceremony_creation": "automatic",
"delivery_type": "email",
"signature_options": [
"typed",
"drawn"
],
"status": "pending",
"status_updated_at": "2026-11-02T14:03:11.000Z",
"completed_at": null
},
{
"id": "re_OcsAUqEe6a6eEqUAscOC2u",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "signer",
"key": "guardian",
"email": "jane.doe@example.com",
"name": "Jane Doe",
"ceremony": {
"authentication": [
{
"type": "email_link",
"subject_override": null,
"message_override": null
}
],
"embeddable_in": [],
"redirect_url": null,
"redirect_delay": 3,
"url": null,
"url_variant": "standard"
},
"ceremony_creation": "automatic",
"delivery_type": "email",
"signature_options": [
"typed",
"drawn"
],
"status": "pending",
"status_updated_at": "2026-11-02T14:03:11.000Z",
"completed_at": null
}
],
"topics": [
"volunteers",
"waivers"
],
"created_at": "2026-11-02T14:03:11.000Z",
"completed_at": null
}{
"type": "https://signatureapi.com/docs/v1/errors/validation-error",
"title": "Validation Error",
"status": 422,
"detail": "The request body contains validation errors.",
"errors": [
"recipients[0].email must be a valid email address"
]
}Errors every call can return are in Errors and Authentication.