Skip to content

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. grade uses custom label and value options. state uses the predefined list us_states_2_letter_codes. See Dropdown.
  • Radio group. lunch_plan has the options none and standard. Each option has its own fixed position, keyed lunch_plan:none and lunch_plan:standard. See Radio group.
  • Validated text input. guardian_email uses format: email with a format_message. See Text input.
  • Captures. Each form place sets capture_as, so the answers come back in the envelope’s captures object. See Captures.
  • Metadata and topics. student_ref and school_year tie 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. Use recipient_key to follow the steps.
  • envelope.completed: the form is complete. Read captures from 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.

Default
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"
    }
  ]
}
{
  "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
}

Errors every call can return are in Errors and Authentication.