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.urlpoints 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
mandatetext, 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.
Related
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"
}
]
}npx signatureapi envelopes create --body - <<'EOF'
{
"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"
}
]
}
EOF{
"name": "create_envelope",
"arguments": {
"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
}{
"type": "https://signatureapi.com/docs/v1/errors/validation-error",
"title": "Validation Error",
"status": 422,
"detail": "The request body contains validation errors.",
"errors": [
"recipients[0].email must be a valid email address"
]
}Errors every call can return are in Errors and Authentication.