Skip to content

Industries

Collect SaaS Order Forms With Countersignature

Let a customer pick a plan from a dropdown, accept the terms and sign, while your company countersigns automatically and the choices come back as captures.

A self-serve order form needs three things from the customer: a plan, acceptance of the terms and a signature. Your company countersigns every order the same way, so use an automatic signer and skip the wait. The plan choice is stored on the envelope, ready for your billing system.

Envelope shape

  • A dropdown for the plan. The plan place is a dropdown with custom options, each with a label and a value. capture_as: "plan" stores the selected value in the envelope’s captures. See Dropdown places.
  • A required terms checkbox. The accept_terms place is a checkbox with requirement: "required", captured as accepted_terms. See Capturing input.
  • An automatic signer. Your company is an automatic_signer with a signature image from POST /v1/uploads and a mandate. No email is sent and no ceremony is created. See Automatic signer.
  • Metadata. order_id and crm_deal tie the envelope to your billing and CRM records.

Routing

The envelope uses sequential routing, which dropdown and checkbox places require. The customer is the only recipient who acts. The automatic signer applies its signature when the envelope is created. See Recipient routing.

Webhooks to listen for

  • recipient.completed: the customer signed. Read envelope_metadata.order_id to find the order.
  • envelope.completed: the order is fully signed. Retrieve the envelope, read captures.plan and captures.accepted_terms, and provision the plan.
  • deliverable.generated: download the signed order form and attach it to the CRM deal.

Set up the endpoint as shown in Set up webhooks.

Compliance notes

This is general information, not legal advice. An automatic signer signs without a person interacting with the document, and its legal weight differs by jurisdiction, as the automatic signer page explains. Have counsel review your order terms and your mandate.

Default
POST /v1/envelopes HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json

{
  "title": "Order Form - Acme Corp Team Plan (sample)",
  "message": "Choose your plan, accept the terms and sign.",
  "routing": "sequential",
  "metadata": {
    "order_id": "ord_9001",
    "crm_deal": "deal_77"
  },
  "topics": [
    "sales",
    "order_forms"
  ],
  "documents": [
    {
      "key": "order_form",
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
      "format": "pdf",
      "fixed_positions": [
        {
          "place_key": "plan",
          "page": 1,
          "top": 130,
          "left": 210
        },
        {
          "place_key": "accept_terms",
          "page": 1,
          "top": 150,
          "left": 210
        },
        {
          "place_key": "customer_signature",
          "page": 1,
          "top": 172,
          "left": 210
        },
        {
          "place_key": "acme_countersignature",
          "page": 1,
          "top": 186,
          "left": 220
        }
      ],
      "places": [
        {
          "key": "plan",
          "type": "dropdown",
          "recipient_key": "customer",
          "prompt": "Plan",
          "options": [
            {
              "label": "Team",
              "value": "team"
            },
            {
              "label": "Business",
              "value": "business"
            }
          ],
          "width": 120,
          "capture_as": "plan"
        },
        {
          "key": "accept_terms",
          "type": "checkbox",
          "recipient_key": "customer",
          "requirement": "required",
          "capture_as": "accepted_terms"
        },
        {
          "key": "customer_signature",
          "type": "signature",
          "recipient_key": "customer"
        },
        {
          "key": "acme_countersignature",
          "type": "signature",
          "recipient_key": "acme"
        }
      ]
    }
  ],
  "recipients": [
    {
      "type": "signer",
      "key": "customer",
      "name": "Jane Doe",
      "email": "jane.doe@example.com"
    },
    {
      "type": "automatic_signer",
      "key": "acme",
      "name": "Acme Corp Authorized Signatory",
      "signature": {
        "type": "drawn",
        "url": "https://api.signatureapi.com/v1/uploads/upl_2bC6tF9gHk3LmQ8rSx5Vy7"
      },
      "mandate": "Authorized by Acme Corp board resolution 2026-04 (synthetic example)"
    }
  ]
}
{
  "id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
  "title": "Order Form - Acme Corp Team Plan (sample)",
  "label": null,
  "message": "Choose your plan, accept the terms 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": [
      "order_form"
    ]
  },
  "metadata": {
    "order_id": "ord_9001",
    "crm_deal": "deal_77"
  },
  "sender": {
    "name": "Acme Corp Legal",
    "email": "legal@acme.example",
    "organization": "Acme Corp"
  },
  "captures": {
    "accepted_terms": false,
    "plan": null
  },
  "documents": [
    {
      "id": "doc_HVl3Nj7XzTzX7jN3lVH5vn",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "key": "order_form",
      "title": null,
      "page_count": 1,
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
      "format": "pdf",
      "fixed_positions": [
        {
          "page": 1,
          "top": 130,
          "left": 210,
          "place_key": "plan"
        },
        {
          "page": 1,
          "top": 150,
          "left": 210,
          "place_key": "accept_terms"
        },
        {
          "page": 1,
          "top": 172,
          "left": 210,
          "place_key": "customer_signature"
        },
        {
          "page": 1,
          "top": 186,
          "left": 220,
          "place_key": "acme_countersignature"
        }
      ],
      "places": [
        {
          "key": "plan",
          "type": "dropdown",
          "recipient_key": "customer",
          "capture_as": "plan",
          "hint": null,
          "prompt": "Plan",
          "requirement": "required",
          "font_size": 12,
          "width": 120,
          "default": null,
          "behavior": "auto",
          "options": [
            {
              "label": "Team",
              "value": "team"
            },
            {
              "label": "Business",
              "value": "business"
            }
          ]
        },
        {
          "key": "accept_terms",
          "type": "checkbox",
          "recipient_key": "customer",
          "height": 20,
          "symbol": "check",
          "capture_as": "accepted_terms",
          "requirement": "required"
        },
        {
          "key": "customer_signature",
          "type": "signature",
          "recipient_key": "customer",
          "height": 60
        },
        {
          "key": "acme_countersignature",
          "type": "signature",
          "recipient_key": "acme",
          "height": 60
        }
      ]
    }
  ],
  "recipients": [
    {
      "id": "re_HVl3Nj7XzTzX7jN3lVH5vn",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "type": "signer",
      "key": "customer",
      "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": "automatic_signer",
      "key": "acme",
      "name": "Acme Corp Authorized Signatory",
      "signature": {
        "type": "drawn",
        "url": "https://api.signatureapi.com/v1/uploads/upl_2bC6tF9gHk3LmQ8rSx5Vy7"
      },
      "initials": null,
      "mandate": "Authorized by Acme Corp board resolution 2026-04 (synthetic example)",
      "status": "awaiting",
      "status_updated_at": "2026-11-02T14:03:11.000Z",
      "completed_at": null
    }
  ],
  "topics": [
    "sales",
    "order_forms"
  ],
  "created_at": "2026-11-02T14:03:11.000Z",
  "completed_at": null
}

Errors every call can return are in Errors and Authentication.