Skip to content

Industries

Send Proposals and Statements of Work

Send a statement of work and a mutual NDA in one envelope, signed by the agency lead and then the client, and name the signed package for your project system.

An agency often needs two documents signed before a project starts: the statement of work (SOW) and a mutual NDA. Sending them as one envelope means one invitation per signer and one signed package at the end.

Envelope shape

  • Two PDF documents. The documents have the keys sow and nda. Each has its own places and fixed_positions, and place keys are unique across the envelope. See Use fixed positions.
  • Two signers, one place each per document. The agency lead and the client each get a signature place on both documents.
  • Named deliverable. deliverable.included_documents lists the document keys that go into the signed package. deliverable.name names it. See Standard deliverable.
  • Metadata and topics. metadata.project_code and metadata.sow_version link the envelope to your project system. The agency and sow topics group these envelopes. See Organize with topics and metadata.

The request has no sender block, so recipients see the account’s default sender. To show another name and email, add a sender block. Its email must already be an authorized sender on your account, or the API returns 422.

Routing

The envelope uses sequential routing. The agency lead is first in the recipients array and signs before the client is notified. That way the client always signs a document your side has already signed. See Sequential signing.

Webhooks to listen for

  • recipient.completed: fires when the agency lead signs and again when the client signs. Use recipient_key to tell which.
  • envelope.completed: both signers have finished. Mark the project as ready to start.
  • deliverable.generated: the package named project_kickoff is ready to download and file with the project.

Set up the endpoint as shown in Set up webhooks.

Compliance notes

This is general information, not legal advice. Whether an electronic signature is valid for a contract or NDA depends on your jurisdiction and the type of agreement, so have counsel review your documents and process. Keep pricing and other confidential terms 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": "Statement of Work and Mutual NDA (sample)",
  "message": "Please sign both documents to start the project.",
  "routing": "sequential",
  "metadata": {
    "project_code": "prj_301",
    "sow_version": "v3"
  },
  "topics": [
    "agency",
    "sow"
  ],
  "deliverable": {
    "type": "standard",
    "name": "project_kickoff",
    "included_documents": [
      "sow",
      "nda"
    ]
  },
  "documents": [
    {
      "key": "sow",
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
      "format": "pdf",
      "fixed_positions": [
        {
          "place_key": "client_signs_sow",
          "page": 1,
          "top": 172,
          "left": 210
        },
        {
          "place_key": "agency_signs_sow",
          "page": 1,
          "top": 186,
          "left": 220
        }
      ],
      "places": [
        {
          "key": "client_signs_sow",
          "type": "signature",
          "recipient_key": "client"
        },
        {
          "key": "agency_signs_sow",
          "type": "signature",
          "recipient_key": "agency"
        }
      ]
    },
    {
      "key": "nda",
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
      "format": "pdf",
      "fixed_positions": [
        {
          "place_key": "client_signs_nda",
          "page": 1,
          "top": 172,
          "left": 210
        },
        {
          "place_key": "agency_signs_nda",
          "page": 1,
          "top": 186,
          "left": 220
        }
      ],
      "places": [
        {
          "key": "client_signs_nda",
          "type": "signature",
          "recipient_key": "client"
        },
        {
          "key": "agency_signs_nda",
          "type": "signature",
          "recipient_key": "agency"
        }
      ]
    }
  ],
  "recipients": [
    {
      "type": "signer",
      "key": "agency",
      "name": "John Smith",
      "email": "john.smith@example.com"
    },
    {
      "type": "signer",
      "key": "client",
      "name": "Jane Doe",
      "email": "jane.doe@example.com"
    }
  ]
}
{
  "id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
  "title": "Statement of Work and Mutual NDA (sample)",
  "label": null,
  "message": "Please sign both documents to start the project.",
  "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": "project_kickoff",
    "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": [
      "sow",
      "nda"
    ]
  },
  "metadata": {
    "project_code": "prj_301",
    "sow_version": "v3"
  },
  "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": "sow",
      "title": null,
      "page_count": 1,
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
      "format": "pdf",
      "fixed_positions": [
        {
          "page": 1,
          "top": 172,
          "left": 210,
          "place_key": "client_signs_sow"
        },
        {
          "page": 1,
          "top": 186,
          "left": 220,
          "place_key": "agency_signs_sow"
        }
      ],
      "places": [
        {
          "key": "client_signs_sow",
          "type": "signature",
          "recipient_key": "client",
          "height": 60
        },
        {
          "key": "agency_signs_sow",
          "type": "signature",
          "recipient_key": "agency",
          "height": 60
        }
      ]
    },
    {
      "id": "doc_OcsAUqEe6a6eEqUAscOC2u",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "key": "nda",
      "title": null,
      "page_count": 1,
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
      "format": "pdf",
      "fixed_positions": [
        {
          "page": 1,
          "top": 172,
          "left": 210,
          "place_key": "client_signs_nda"
        },
        {
          "page": 1,
          "top": 186,
          "left": 220,
          "place_key": "agency_signs_nda"
        }
      ],
      "places": [
        {
          "key": "client_signs_nda",
          "type": "signature",
          "recipient_key": "client",
          "height": 60
        },
        {
          "key": "agency_signs_nda",
          "type": "signature",
          "recipient_key": "agency",
          "height": 60
        }
      ]
    }
  ],
  "recipients": [
    {
      "id": "re_HVl3Nj7XzTzX7jN3lVH5vn",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "type": "signer",
      "key": "agency",
      "email": "john.smith@example.com",
      "name": "John Smith",
      "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": "client",
      "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": "awaiting",
      "status_updated_at": "2026-11-02T14:03:11.000Z",
      "completed_at": null
    }
  ],
  "topics": [
    "agency",
    "sow"
  ],
  "created_at": "2026-11-02T14:03:11.000Z",
  "completed_at": null
}

Errors every call can return are in Errors and Authentication.