API Documentation

{
  "documentId": "doc_abc123",
  "name": "Service Agreement",
  "hash": "sha256:a1b2c3d4e5f6...",
  "envelopeId": "5f88a936-fa42-4791-aa22-638f81fc186d",
  "signatories": [
    {
      "name": "John Doe",
      "email": "john@example.com",
      "signingUrl": "https://app.inscriben.com/sign/tok_xyz789"
    }
  ]
}

# ── Option 1: Single file — default stamp placement (bottom-right) ──
curl -X POST \
  https://app.inscriben.com/api/v1/documents/send-for-signature \
  -H "Authorization: Bearer ss_YOUR_API_KEY" \
  -F "file=@contract.pdf" \
  -F 'name=Service Agreement' \
  -F 'signatories=[{"name":"John Doe","email":"john@example.com"}]'

# ── Option 2: Auto placement — scan PDF for "Sign Here" / "Signature:" labels ──
curl -X POST \
  https://app.inscriben.com/api/v1/documents/send-for-signature \
  -H "Authorization: Bearer ss_YOUR_API_KEY" \
  -F "file=@contract.pdf" \
  -F 'name=Service Agreement' \
  -F 'placementMode=auto' \
  -F 'signatories=[{"name":"John Doe","email":"john@example.com"}]'

# ── Option 3: Manual placement — specify exact coordinates per signatory ──
# placements[]: array of {page, x, y, width, height} all as % of page dimensions
# x/y = distance from top-left corner; width/height control stamp size
curl -X POST \
  https://app.inscriben.com/api/v1/documents/send-for-signature \
  -H "Authorization: Bearer ss_YOUR_API_KEY" \
  -F "file=@contract.pdf" \
  -F 'name=Service Agreement' \
  -F 'placementMode=manual' \
  -F 'signatories=[{"name":"John Doe","email":"john@example.com","placements":[{"page":1,"x":60,"y":80,"width":30,"height":8}]}]'

# ── Option 4: Multiple files in one call (auto-envelope) ──
curl -X POST \
  https://app.inscriben.com/api/v1/documents/send-for-signature \
  -H "Authorization: Bearer ss_YOUR_API_KEY" \
  -F "files=@nda.pdf" \
  -F "files=@contract.pdf" \
  -F "files=@annex.pdf" \
  -F 'name=Deal Package' \
  -F 'signatories=[{"name":"John Doe","email":"john@example.com"}]'

# ── Option 5: Auto-batch (multiple separate calls) ──
# When you call send-for-signature multiple times within 5 seconds
# for the same signatory, documents are automatically grouped
# into one envelope with one invitation email.
# No extra parameters needed — just call normally.