---
title: "Send Enrollment Agreements and Permission Slips"
description: "Collect enrollment details with dropdowns, a radio group and a validated email field, then have the guardian and the student sign in order."
canonical: "https://signatureapi.com/docs/use-cases/education-enrollment"
source: "https://signatureapi.com/docs/use-cases/education-enrollment.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T17:35:55Z"
---

# 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.

_Last verified against API version 1.18.0._

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](https://signatureapi.com/docs/api/resources/places/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](https://signatureapi.com/docs/api/resources/places/radio-group).
- **Validated text input.** `guardian_email` uses `format: email` with a `format_message`. See [Text input](https://signatureapi.com/docs/api/resources/places/text-input).
- **Captures.** Each form place sets `capture_as`, so the answers come back in the envelope's `captures` object. See [Captures](https://signatureapi.com/docs/api/resources/envelopes/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](https://signatureapi.com/docs/api/guides/how-to/sequential-signing).

## Webhooks to listen for

- [`recipient.completed`](https://signatureapi.com/docs/api/resources/events/recipient-events): fires for the guardian, then for the student. Use `recipient_key` to follow the steps.
- [`envelope.completed`](https://signatureapi.com/docs/api/resources/events/envelope-events): the form is complete. Read `captures` from the envelope and write the answers to the student record.
- [`deliverable.generated`](https://signatureapi.com/docs/api/resources/events/deliverable-events): the signed form is ready to download and file.

Set up the endpoint as shown in [Set up webhooks](https://signatureapi.com/docs/api/guides/how-to/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.

### Example: Default

Enrollment Form (sample).

```http
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"
    }
  ]
}
```

Response 201 Created:

```json
{
  "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
}
```

Response 422 Unprocessable Content:

```json
{
  "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 that any request can return (authentication, rate limits, server errors) are on the [Errors](https://signatureapi.com/docs/api/errors) and [Authentication](https://signatureapi.com/docs/api/authentication) pages.
