Industries
Send Enrollment Agreements and Permission Slips
Collect enrollment details with dropdowns, a radio group and a validated email field, then have the guardian and the student sign in order.
A school collects the same details from every family: grade, state, a contact email and a lunch plan. Put those fields on the form itself. The guardian fills them in and signs, then the student signs, and your system reads the answers from the envelope.
Envelope shape
- Dropdowns.
gradeuses customlabelandvalueoptions.stateuses the predefined listus_states_2_letter_codes. See Dropdown. - Radio group.
lunch_planhas the optionsnoneandstandard. Each option has its own fixed position, keyedlunch_plan:noneandlunch_plan:standard. See Radio group. - Validated text input.
guardian_emailusesformat: emailwith aformat_message. See Text input. - Captures. Each form place sets
capture_as, so the answers come back in the envelope’scapturesobject. See Captures. - Metadata and topics.
student_refandschool_yeartie the envelope to your student record.
Routing
The envelope uses sequential routing. The guardian fills in the form and signs first, then the student signs. Form places (text inputs, checkboxes, dropdowns and radio groups) are allowed only on sequential envelopes, and a parallel envelope that has them returns 422. See Sequential signing.
Webhooks to listen for
recipient.completed: fires for the guardian, then for the student. Userecipient_keyto follow the steps.envelope.completed: the form is complete. Readcapturesfrom the envelope and write the answers to the student record.deliverable.generated: the signed form is ready to download and file.
Set up the endpoint as shown in Set up webhooks.
Compliance notes
This is general information, not legal advice. Rules on student records and on electronic signatures by minors and guardians depend on your jurisdiction and institution, so have counsel review your forms and process. Captured values appear in the envelope, so keep sensitive student data out of metadata and limit what you collect.
POST /v1/envelopes HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
{
"title": "Enrollment Form (sample)",
"message": "Please complete the enrollment form and sign.",
"routing": "sequential",
"metadata": {
"student_ref": "stu_8812",
"school_year": "2027_2028"
},
"topics": [
"education",
"enrollment"
],
"documents": [
{
"key": "enrollment_form",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "grade",
"page": 1,
"top": 110,
"left": 210
},
{
"place_key": "state",
"page": 1,
"top": 130,
"left": 210
},
{
"place_key": "guardian_email",
"page": 1,
"top": 150,
"left": 210
},
{
"place_key": "lunch_plan:none",
"page": 1,
"top": 200,
"left": 210
},
{
"place_key": "lunch_plan:standard",
"page": 1,
"top": 200,
"left": 330
},
{
"place_key": "guardian_signature",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "student_signature",
"page": 1,
"top": 186,
"left": 220
}
],
"places": [
{
"key": "grade",
"type": "dropdown",
"recipient_key": "guardian",
"prompt": "Grade",
"options": [
{
"label": "Grade 6",
"value": "g6"
},
{
"label": "Grade 7",
"value": "g7"
},
{
"label": "Grade 8",
"value": "g8"
}
],
"width": 120,
"capture_as": "grade"
},
{
"key": "state",
"type": "dropdown",
"recipient_key": "guardian",
"prompt": "State",
"options": "us_states_2_letter_codes",
"width": 80,
"capture_as": "state"
},
{
"key": "guardian_email",
"type": "text_input",
"recipient_key": "guardian",
"prompt": "Contact email",
"format": "email",
"format_message": "Enter a valid email address",
"width": 220,
"capture_as": "guardian_email"
},
{
"key": "lunch_plan",
"type": "radio_group",
"recipient_key": "guardian",
"options": [
{
"value": "none"
},
{
"value": "standard"
}
],
"capture_as": "lunch_plan"
},
{
"key": "guardian_signature",
"type": "signature",
"recipient_key": "guardian"
},
{
"key": "student_signature",
"type": "signature",
"recipient_key": "student"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "guardian",
"name": "Jane Doe",
"email": "jane.doe@example.com"
},
{
"type": "signer",
"key": "student",
"name": "Maria Garcia",
"email": "maria.garcia@example.com"
}
]
}npx signatureapi envelopes create --body - <<'EOF'
{
"title": "Enrollment Form (sample)",
"message": "Please complete the enrollment form and sign.",
"routing": "sequential",
"metadata": {
"student_ref": "stu_8812",
"school_year": "2027_2028"
},
"topics": [
"education",
"enrollment"
],
"documents": [
{
"key": "enrollment_form",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "grade",
"page": 1,
"top": 110,
"left": 210
},
{
"place_key": "state",
"page": 1,
"top": 130,
"left": 210
},
{
"place_key": "guardian_email",
"page": 1,
"top": 150,
"left": 210
},
{
"place_key": "lunch_plan:none",
"page": 1,
"top": 200,
"left": 210
},
{
"place_key": "lunch_plan:standard",
"page": 1,
"top": 200,
"left": 330
},
{
"place_key": "guardian_signature",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "student_signature",
"page": 1,
"top": 186,
"left": 220
}
],
"places": [
{
"key": "grade",
"type": "dropdown",
"recipient_key": "guardian",
"prompt": "Grade",
"options": [
{
"label": "Grade 6",
"value": "g6"
},
{
"label": "Grade 7",
"value": "g7"
},
{
"label": "Grade 8",
"value": "g8"
}
],
"width": 120,
"capture_as": "grade"
},
{
"key": "state",
"type": "dropdown",
"recipient_key": "guardian",
"prompt": "State",
"options": "us_states_2_letter_codes",
"width": 80,
"capture_as": "state"
},
{
"key": "guardian_email",
"type": "text_input",
"recipient_key": "guardian",
"prompt": "Contact email",
"format": "email",
"format_message": "Enter a valid email address",
"width": 220,
"capture_as": "guardian_email"
},
{
"key": "lunch_plan",
"type": "radio_group",
"recipient_key": "guardian",
"options": [
{
"value": "none"
},
{
"value": "standard"
}
],
"capture_as": "lunch_plan"
},
{
"key": "guardian_signature",
"type": "signature",
"recipient_key": "guardian"
},
{
"key": "student_signature",
"type": "signature",
"recipient_key": "student"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "guardian",
"name": "Jane Doe",
"email": "jane.doe@example.com"
},
{
"type": "signer",
"key": "student",
"name": "Maria Garcia",
"email": "maria.garcia@example.com"
}
]
}
EOF{
"name": "create_envelope",
"arguments": {
"title": "Enrollment Form (sample)",
"message": "Please complete the enrollment form and sign.",
"routing": "sequential",
"metadata": {
"student_ref": "stu_8812",
"school_year": "2027_2028"
},
"topics": [
"education",
"enrollment"
],
"documents": [
{
"key": "enrollment_form",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "grade",
"page": 1,
"top": 110,
"left": 210
},
{
"place_key": "state",
"page": 1,
"top": 130,
"left": 210
},
{
"place_key": "guardian_email",
"page": 1,
"top": 150,
"left": 210
},
{
"place_key": "lunch_plan:none",
"page": 1,
"top": 200,
"left": 210
},
{
"place_key": "lunch_plan:standard",
"page": 1,
"top": 200,
"left": 330
},
{
"place_key": "guardian_signature",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "student_signature",
"page": 1,
"top": 186,
"left": 220
}
],
"places": [
{
"key": "grade",
"type": "dropdown",
"recipient_key": "guardian",
"prompt": "Grade",
"options": [
{
"label": "Grade 6",
"value": "g6"
},
{
"label": "Grade 7",
"value": "g7"
},
{
"label": "Grade 8",
"value": "g8"
}
],
"width": 120,
"capture_as": "grade"
},
{
"key": "state",
"type": "dropdown",
"recipient_key": "guardian",
"prompt": "State",
"options": "us_states_2_letter_codes",
"width": 80,
"capture_as": "state"
},
{
"key": "guardian_email",
"type": "text_input",
"recipient_key": "guardian",
"prompt": "Contact email",
"format": "email",
"format_message": "Enter a valid email address",
"width": 220,
"capture_as": "guardian_email"
},
{
"key": "lunch_plan",
"type": "radio_group",
"recipient_key": "guardian",
"options": [
{
"value": "none"
},
{
"value": "standard"
}
],
"capture_as": "lunch_plan"
},
{
"key": "guardian_signature",
"type": "signature",
"recipient_key": "guardian"
},
{
"key": "student_signature",
"type": "signature",
"recipient_key": "student"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "guardian",
"name": "Jane Doe",
"email": "jane.doe@example.com"
},
{
"type": "signer",
"key": "student",
"name": "Maria Garcia",
"email": "maria.garcia@example.com"
}
]
}
}{
"id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"title": "Enrollment Form (sample)",
"label": null,
"message": "Please complete the enrollment form and sign.",
"status": "processing",
"attestation": "none",
"language": "en",
"mode": "test",
"routing": "sequential",
"timezone": "UTC",
"timestamp_format": "MM/DD/YYYY HH:mm:ss",
"snapshot_url": null,
"branding": {
"logo": null,
"accent_color": "#2463EB",
"email": {
"footer": null,
"logo_position": "left",
"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": [
"enrollment_form"
]
},
"metadata": {
"student_ref": "stu_8812",
"school_year": "2027_2028"
},
"sender": {
"name": "Acme Corp Legal",
"email": "legal@acme.example",
"organization": "Acme Corp"
},
"captures": {
"grade": null,
"guardian_email": null,
"lunch_plan": null,
"state": null
},
"documents": [
{
"id": "doc_HVl3Nj7XzTzX7jN3lVH5vn",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"key": "enrollment_form",
"title": null,
"page_count": 1,
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"page": 1,
"top": 110,
"left": 210,
"place_key": "grade"
},
{
"page": 1,
"top": 130,
"left": 210,
"place_key": "state"
},
{
"page": 1,
"top": 150,
"left": 210,
"place_key": "guardian_email"
},
{
"page": 1,
"top": 200,
"left": 210,
"place_key": "lunch_plan:none"
},
{
"page": 1,
"top": 200,
"left": 330,
"place_key": "lunch_plan:standard"
},
{
"page": 1,
"top": 172,
"left": 210,
"place_key": "guardian_signature"
},
{
"page": 1,
"top": 186,
"left": 220,
"place_key": "student_signature"
}
],
"places": [
{
"key": "grade",
"type": "dropdown",
"recipient_key": "guardian",
"capture_as": "grade",
"hint": null,
"prompt": "Grade",
"requirement": "required",
"font_size": 12,
"width": 120,
"default": null,
"behavior": "auto",
"options": [
{
"label": "Grade 6",
"value": "g6"
},
{
"label": "Grade 7",
"value": "g7"
},
{
"label": "Grade 8",
"value": "g8"
}
]
},
{
"key": "state",
"type": "dropdown",
"recipient_key": "guardian",
"capture_as": "state",
"hint": null,
"prompt": "State",
"requirement": "required",
"font_size": 12,
"width": 80,
"default": null,
"behavior": "auto",
"options": "us_states_2_letter_codes"
},
{
"key": "guardian_email",
"type": "text_input",
"recipient_key": "guardian",
"capture_as": "guardian_email",
"hint": null,
"format": "email",
"prompt": "Contact email",
"requirement": "required",
"format_message": "Enter a valid email address",
"font_size": 12,
"width": 220
},
{
"key": "lunch_plan",
"type": "radio_group",
"recipient_key": "guardian",
"height": 20,
"symbol": "fill",
"shape": "circle",
"capture_as": "lunch_plan",
"requirement": "required",
"default": null,
"options": [
{
"value": "none"
},
{
"value": "standard"
}
]
},
{
"key": "guardian_signature",
"type": "signature",
"recipient_key": "guardian",
"height": 60
},
{
"key": "student_signature",
"type": "signature",
"recipient_key": "student",
"height": 60
}
]
}
],
"recipients": [
{
"id": "re_HVl3Nj7XzTzX7jN3lVH5vn",
"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
},
{
"id": "re_OcsAUqEe6a6eEqUAscOC2u",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "signer",
"key": "student",
"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": "awaiting",
"status_updated_at": "2026-11-02T14:03:11.000Z",
"completed_at": null
}
],
"topics": [
"education",
"enrollment"
],
"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.