Skip to content

Cookbook

Board resolution signed in parallel

Send one resolution to several directors at once so each signs in any order, using parallel routing and one signature place per director.

Send a resolution to three directors at the same time. Each signs when ready, and the envelope completes when the last one has.

  • Parallel routing. Every director is notified when the envelope starts. See parallel signing.
  • Only signing recipient types. Parallel routing accepts signer, qualified_signer and automatic_signer recipients. An approver or preparer needs sequential.
  • No form fields. Text inputs, checkboxes and dropdowns are allowed only in sequential envelopes.
  • Fixed positions. This sample PDF has no placeholders, so each director’s place gets a page and coordinates, side by side on the signature line. Use your own coordinates for your document: see fixed positions.

Follow progress

Each signature fires recipient.completed, and envelope.completed fires after the last. A director who declines fires recipient.rejected but does not cancel the envelope. To chase a slow director, see scheduled reminders.

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

{
  "title": "Board Resolution 2026-11",
  "message": "Please review and sign the board resolution.",
  "routing": "parallel",
  "topics": [
    "board"
  ],
  "documents": [
    {
      "key": "resolution",
      "title": "Board Resolution 2026-11",
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/privacy-fixed.pdf",
      "format": "pdf",
      "fixed_positions": [
        {
          "place_key": "director_1",
          "page": 2,
          "top": 410,
          "left": 73
        },
        {
          "place_key": "director_2",
          "page": 2,
          "top": 410,
          "left": 233
        },
        {
          "place_key": "director_3",
          "page": 2,
          "top": 410,
          "left": 393
        }
      ],
      "places": [
        {
          "key": "director_1",
          "type": "signature",
          "recipient_key": "jane"
        },
        {
          "key": "director_2",
          "type": "signature",
          "recipient_key": "john"
        },
        {
          "key": "director_3",
          "type": "signature",
          "recipient_key": "maria"
        }
      ]
    }
  ],
  "recipients": [
    {
      "type": "signer",
      "key": "jane",
      "name": "Jane Doe",
      "email": "jane.doe@example.com"
    },
    {
      "type": "signer",
      "key": "john",
      "name": "John Smith",
      "email": "john.smith@example.com"
    },
    {
      "type": "signer",
      "key": "maria",
      "name": "Maria Garcia",
      "email": "maria.garcia@example.com"
    }
  ]
}
{
  "id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
  "title": "Board Resolution 2026-11",
  "label": null,
  "message": "Please review and sign the board resolution.",
  "status": "processing",
  "mode": "test",
  "routing": "parallel",
  "language": "en",
  "timezone": "UTC",
  "timestamp_format": "MM/DD/YYYY HH:mm:ss",
  "attestation": "none",
  "branding": {
    "logo": null,
    "accent_color": "#2463eb",
    "email": {
      "from": "noreply@signatureapi.com",
      "footer": null,
      "logo_position": "left"
    }
  },
  "sender": {
    "name": "Acme Corp Legal",
    "email": "legal@acme.example",
    "organization": "Acme Corp"
  },
  "topics": [
    "board"
  ],
  "metadata": {},
  "documents": [
    {
      "id": "doc_4YvlxUZN28CeonDq6rTbvk",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "key": "resolution",
      "title": "Board Resolution 2026-11",
      "page_count": 2,
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/privacy-fixed.pdf",
      "format": "pdf",
      "fixed_positions": [
        {
          "place_key": "director_1",
          "page": 2,
          "top": 410,
          "left": 73
        },
        {
          "place_key": "director_2",
          "page": 2,
          "top": 410,
          "left": 233
        },
        {
          "place_key": "director_3",
          "page": 2,
          "top": 410,
          "left": 393
        }
      ],
      "places": [
        {
          "key": "director_1",
          "type": "signature",
          "recipient_key": "jane",
          "height": 60
        },
        {
          "key": "director_2",
          "type": "signature",
          "recipient_key": "john",
          "height": 60
        },
        {
          "key": "director_3",
          "type": "signature",
          "recipient_key": "maria",
          "height": 60
        }
      ]
    }
  ],
  "recipients": [
    {
      "id": "re_49r1R2jpPDz8hSpP75ZkPp",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "type": "signer",
      "key": "jane",
      "name": "Jane Doe",
      "email": "jane.doe@example.com",
      "status": "pending",
      "ceremony": {
        "authentication": [
          {
            "type": "email_link",
            "subject_override": null,
            "message_override": null
          }
        ],
        "redirect_url": null,
        "redirect_delay": 3,
        "embeddable_in": [],
        "url_variant": "standard",
        "url": null
      },
      "delivery_type": "email",
      "ceremony_creation": "automatic",
      "signature_options": [
        "typed",
        "drawn"
      ],
      "completed_at": null,
      "status_updated_at": "2026-11-02T14:03:11.000Z"
    },
    {
      "id": "re_4VP9v4uPj6jwZzQ14CG2O8",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "type": "signer",
      "key": "john",
      "name": "John Smith",
      "email": "john.smith@example.com",
      "status": "pending",
      "ceremony": {
        "authentication": [
          {
            "type": "email_link",
            "subject_override": null,
            "message_override": null
          }
        ],
        "redirect_url": null,
        "redirect_delay": 3,
        "embeddable_in": [],
        "url_variant": "standard",
        "url": null
      },
      "delivery_type": "email",
      "ceremony_creation": "automatic",
      "signature_options": [
        "typed",
        "drawn"
      ],
      "completed_at": null,
      "status_updated_at": "2026-11-02T14:03:11.000Z"
    },
    {
      "id": "re_2f0wBwlt2te0kjU5QeL3Nl",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "type": "signer",
      "key": "maria",
      "name": "Maria Garcia",
      "email": "maria.garcia@example.com",
      "status": "pending",
      "ceremony": {
        "authentication": [
          {
            "type": "email_link",
            "subject_override": null,
            "message_override": null
          }
        ],
        "redirect_url": null,
        "redirect_delay": 3,
        "embeddable_in": [],
        "url_variant": "standard",
        "url": null
      },
      "delivery_type": "email",
      "ceremony_creation": "automatic",
      "signature_options": [
        "typed",
        "drawn"
      ],
      "completed_at": null,
      "status_updated_at": "2026-11-02T14:03:11.000Z"
    }
  ],
  "deliverable": {
    "id": "del_6FF89lKNyTNamOJCJd1tLL",
    "name": null,
    "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
    "type": "standard",
    "status": "pending",
    "url": null,
    "language": "en",
    "timezone": "UTC",
    "timestamp_format": "MM/DD/YYYY HH:mm:ss",
    "included_documents": [
      "resolution"
    ],
    "password": null,
    "created_at": "2026-11-02T14:03:11.000Z",
    "generated_at": null
  },
  "captures": {},
  "snapshot_url": null,
  "created_at": "2026-11-02T14:03:11.000Z",
  "completed_at": null
}

Errors every call can return are in Errors and Authentication.