Skip to content

Cookbook

Countersign automatically after the customer signs

Apply your company's signature automatically once the customer has signed, using a sequential envelope with an automatic signer listed second.

The customer signs a contract, and your signature is applied right after, with nobody on your side clicking anything. An automatic signer applies a signature image you supply, under a mandate you record.

  • Listed second. In a sequential envelope the automatic signer completes when its turn comes, so the signature is applied as soon as the customer completes. In a parallel envelope it would sign as soon as the envelope starts.
  • The signature is an upload. signature.url points to a PNG you uploaded: create it with Create an upload, and store it to reuse it, because a temporary upload expires and an expired one is rejected.
  • The mandate is recorded. Your mandate text, up to 500 characters, is printed verbatim on the audit log. Write it as a complete sentence.
  • No email, no ceremony. The automatic signer has no email and no deliverable email. Distribute the signed copy yourself.
An automatic signer doesn’t carry the same legal weight as a signer who interacts with the document in every jurisdiction. Read Automatic signer and ask your legal counsel before using it for high-risk documents.
Customer signs, then Acme countersigns
POST /v1/envelopes HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json

{
  "title": "Service Agreement",
  "message": "Please review and sign the agreement.",
  "routing": "sequential",
  "metadata": {
    "customer_id": "cust_5678"
  },
  "documents": [
    {
      "key": "agreement",
      "title": "Service Agreement",
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/acme-service-agreement.pdf",
      "format": "pdf",
      "places": [
        {
          "key": "client_signs_here",
          "type": "signature",
          "recipient_key": "customer"
        },
        {
          "key": "provider_signs_here",
          "type": "signature",
          "recipient_key": "acme"
        }
      ]
    }
  ],
  "recipients": [
    {
      "type": "signer",
      "key": "customer",
      "name": "Jane Doe",
      "email": "jane.doe@example.com"
    },
    {
      "type": "automatic_signer",
      "key": "acme",
      "name": "John Smith",
      "signature": {
        "type": "drawn",
        "url": "https://api.signatureapi.com/v1/uploads/upl_2bC6tF9gHk3LmQ8rSx5Vy7"
      },
      "mandate": "Standing authorization to countersign customer agreements, recorded on 2026-01-15"
    }
  ]
}
{
  "id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
  "title": "Service Agreement",
  "label": null,
  "message": "Please review and sign the agreement.",
  "status": "processing",
  "mode": "test",
  "routing": "sequential",
  "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": [],
  "metadata": {
    "customer_id": "cust_5678"
  },
  "documents": [
    {
      "id": "doc_4YvlxUZN28CeonDq6rTbvk",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "key": "agreement",
      "title": "Service Agreement",
      "page_count": 1,
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/acme-service-agreement.pdf",
      "format": "pdf",
      "fixed_positions": [],
      "places": [
        {
          "key": "client_signs_here",
          "type": "signature",
          "recipient_key": "customer",
          "height": 60
        },
        {
          "key": "provider_signs_here",
          "type": "signature",
          "recipient_key": "acme",
          "height": 60
        }
      ]
    }
  ],
  "recipients": [
    {
      "id": "re_49r1R2jpPDz8hSpP75ZkPp",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "type": "signer",
      "key": "customer",
      "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": "automatic_signer",
      "key": "acme",
      "name": "John Smith",
      "signature": {
        "type": "drawn",
        "url": "https://api.signatureapi.com/v1/uploads/upl_2bC6tF9gHk3LmQ8rSx5Vy7"
      },
      "initials": null,
      "mandate": "Standing authorization to countersign customer agreements, recorded on 2026-01-15",
      "status": "pending",
      "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": [
      "agreement"
    ],
    "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.