Skip to content

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 signer recipients. The volunteer has an initials place for the risk acknowledgement and a signature place. The guardian has a signature place. See Initials and Signature.
  • Places by fixed position. The fixed_positions array pins each place key to a page, top and left. See Use fixed positions.
  • Branding. branding.accent_color sets the color of the ceremony and emails. branding.email.footer and logo_position adjust the email. See Customize branding.
  • Metadata and topics. metadata.event_id ties the envelope to the event. The volunteers and waivers topics 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. Read recipient_key to 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.

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

Errors every call can return are in Errors and Authentication.