Skip to content
inSigner Docs

Quickstart

Send your first document for electronic signature in under 5 minutes. This guide walks through the complete flow using curl.

  1. Create a document

    Terminal window
    curl -X POST https://app.insigner.co/api/v1/documents \
      -H "Authorization: Bearer isk_YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "name": "Sales Agreement Q3",
        "signingType": "sequential",
        "message": "Please review and sign this agreement."
      }'

    Save the id from the response — you’ll need it for the next steps.

    {
      "data": {
        "id": "cm5x9abc123",
        "name": "Sales Agreement Q3",
        "status": "draft",
        "signingType": "sequential",
        "createdAt": "2026-05-28T12:00:00.000Z"
      }
    }

  2. Upload the PDF

    First, get a presigned upload URL:

    Terminal window
    curl -X POST https://app.insigner.co/api/v1/documents/cm5x9abc123/upload \
      -H "Authorization: Bearer isk_YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "filename": "sales-agreement.pdf",
        "contentType": "application/pdf",
        "fileSize": 245000
      }'

    Then upload the file directly to the presigned URL:

    Terminal window
    curl -X PUT "PRESIGNED_UPLOAD_URL" \
      -H "Content-Type: application/pdf" \
      --data-binary @sales-agreement.pdf

  3. Add signature fields

    Place a signature field on page 1:

    Terminal window
    curl -X POST https://app.insigner.co/api/v1/documents/cm5x9abc123/fields \
      -H "Authorization: Bearer isk_YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "type": "signature",
        "label": "Client Signature",
        "page": 1,
        "x": 100,
        "y": 650,
        "width": 200,
        "height": 60,
        "required": true,
        "assignedTo": 0
      }'

  4. Add a signer

    Terminal window
    curl -X POST https://app.insigner.co/api/v1/documents/cm5x9abc123/signers \
      -H "Authorization: Bearer isk_YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "email": "jane.smith@acme.com",
        "name": "Jane Smith",
        "role": "signer",
        "order": 0
      }'

  5. Send for signing

    Terminal window
    curl -X POST https://app.insigner.co/api/v1/documents/cm5x9abc123/send \
      -H "Authorization: Bearer isk_YOUR_API_KEY"

    Jane will receive an email with a link to review and sign the document. Once she signs, the document status changes to completed.

  6. Download the signed PDF

    After the document is completed:

    Terminal window
    curl -X GET https://app.insigner.co/api/v1/documents/cm5x9abc123/download \
      -H "Authorization: Bearer isk_YOUR_API_KEY" \
      -o "Sales Agreement Q3 - Signed.pdf"

What’s next?

Section titled “What’s next?”