Industries
Open Accounts With Automatic Countersignature
Send an account agreement the customer signs after two email checks, with your institution's countersignature applied automatically under a recorded mandate.
Account opening needs the customer agreement signed and countersigned before funds can move. A manual countersignature step slows every new customer, and a signing link sent by plain email is weak protection for a financial document. This envelope adds a second authentication step for the customer and applies your countersignature automatically.
Envelope shape
- Two authentication methods. The customer’s ceremony uses
email_linkthenemail_code. The customer needs the emailed link and a code from a separate email. See Multiple authentication methods. - Automatic countersignature. The
institutionrecipient is anautomatic_signerwith an uploaded signature image and amandatethat records your authority to sign. It has no email and no ceremony. See Automatic signer and Uploads. - Two required checkboxes.
accepted_termsandaccepted_esignmust be checked, and each value is stored incapturesthroughcapture_as. See Checkbox. - Standard deliverable. The signed agreement comes with an audit log. See Standard deliverable.
Routing
The envelope uses sequential routing: the customer is first and the institution second. Checkboxes are form places, which need sequential routing. Only the customer has form places, because an automatic signer cannot have them. See Sequential signing.
Webhooks to listen for
recipient.hard_bounced: the invitation email could not be delivered. Ask the customer for a valid address, then replace the recipient.recipient.completed: the customer finished both authentication steps and signed. Readenvelope_metadata.application_idto find the application.envelope.completed: both signatures are in place. Release the account for funding.deliverable.generated: download the signed agreement and audit log into the customer file.
Compliance notes
This is general information, not legal advice. Account-opening, identity verification and record-keeping rules for financial institutions vary by jurisdiction and regulator, and email authentication does not replace the identity checks your program requires. An automatic signer does not carry the same weight in every jurisdiction, so have counsel review it before you use it. Keep account numbers and other personal data out of metadata, which appears in webhook payloads.
POST /v1/envelopes HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
{
"title": "Account Agreement (sample)",
"message": "Please accept the terms and sign your account agreement.",
"routing": "sequential",
"metadata": {
"application_id": "app_8841"
},
"topics": [
"fintech",
"account_opening"
],
"deliverable": {
"type": "standard"
},
"documents": [
{
"key": "account_agreement",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "accept_terms",
"page": 1,
"top": 130,
"left": 210
},
{
"place_key": "accept_esign",
"page": 1,
"top": 150,
"left": 210
},
{
"place_key": "customer_signature",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "institution_countersignature",
"page": 1,
"top": 186,
"left": 220
}
],
"places": [
{
"key": "accept_terms",
"type": "checkbox",
"recipient_key": "customer",
"requirement": "required",
"capture_as": "accepted_terms"
},
{
"key": "accept_esign",
"type": "checkbox",
"recipient_key": "customer",
"requirement": "required",
"capture_as": "accepted_esign"
},
{
"key": "customer_signature",
"type": "signature",
"recipient_key": "customer"
},
{
"key": "institution_countersignature",
"type": "signature",
"recipient_key": "institution"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "customer",
"name": "Jane Doe",
"email": "jane.doe@example.com",
"ceremony": {
"authentication": [
{
"type": "email_link"
},
{
"type": "email_code"
}
]
}
},
{
"type": "automatic_signer",
"key": "institution",
"name": "Acme Corp Authorized Signatory",
"signature": {
"type": "drawn",
"url": "https://api.signatureapi.com/v1/uploads/upl_2bC6tF9gHk3LmQ8rSx5Vy7"
},
"mandate": "Authorized by Acme Corp board resolution 2026-04 (synthetic example)"
}
]
}npx signatureapi envelopes create --body - <<'EOF'
{
"title": "Account Agreement (sample)",
"message": "Please accept the terms and sign your account agreement.",
"routing": "sequential",
"metadata": {
"application_id": "app_8841"
},
"topics": [
"fintech",
"account_opening"
],
"deliverable": {
"type": "standard"
},
"documents": [
{
"key": "account_agreement",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "accept_terms",
"page": 1,
"top": 130,
"left": 210
},
{
"place_key": "accept_esign",
"page": 1,
"top": 150,
"left": 210
},
{
"place_key": "customer_signature",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "institution_countersignature",
"page": 1,
"top": 186,
"left": 220
}
],
"places": [
{
"key": "accept_terms",
"type": "checkbox",
"recipient_key": "customer",
"requirement": "required",
"capture_as": "accepted_terms"
},
{
"key": "accept_esign",
"type": "checkbox",
"recipient_key": "customer",
"requirement": "required",
"capture_as": "accepted_esign"
},
{
"key": "customer_signature",
"type": "signature",
"recipient_key": "customer"
},
{
"key": "institution_countersignature",
"type": "signature",
"recipient_key": "institution"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "customer",
"name": "Jane Doe",
"email": "jane.doe@example.com",
"ceremony": {
"authentication": [
{
"type": "email_link"
},
{
"type": "email_code"
}
]
}
},
{
"type": "automatic_signer",
"key": "institution",
"name": "Acme Corp Authorized Signatory",
"signature": {
"type": "drawn",
"url": "https://api.signatureapi.com/v1/uploads/upl_2bC6tF9gHk3LmQ8rSx5Vy7"
},
"mandate": "Authorized by Acme Corp board resolution 2026-04 (synthetic example)"
}
]
}
EOF{
"name": "create_envelope",
"arguments": {
"title": "Account Agreement (sample)",
"message": "Please accept the terms and sign your account agreement.",
"routing": "sequential",
"metadata": {
"application_id": "app_8841"
},
"topics": [
"fintech",
"account_opening"
],
"deliverable": {
"type": "standard"
},
"documents": [
{
"key": "account_agreement",
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"place_key": "accept_terms",
"page": 1,
"top": 130,
"left": 210
},
{
"place_key": "accept_esign",
"page": 1,
"top": 150,
"left": 210
},
{
"place_key": "customer_signature",
"page": 1,
"top": 172,
"left": 210
},
{
"place_key": "institution_countersignature",
"page": 1,
"top": 186,
"left": 220
}
],
"places": [
{
"key": "accept_terms",
"type": "checkbox",
"recipient_key": "customer",
"requirement": "required",
"capture_as": "accepted_terms"
},
{
"key": "accept_esign",
"type": "checkbox",
"recipient_key": "customer",
"requirement": "required",
"capture_as": "accepted_esign"
},
{
"key": "customer_signature",
"type": "signature",
"recipient_key": "customer"
},
{
"key": "institution_countersignature",
"type": "signature",
"recipient_key": "institution"
}
]
}
],
"recipients": [
{
"type": "signer",
"key": "customer",
"name": "Jane Doe",
"email": "jane.doe@example.com",
"ceremony": {
"authentication": [
{
"type": "email_link"
},
{
"type": "email_code"
}
]
}
},
{
"type": "automatic_signer",
"key": "institution",
"name": "Acme Corp Authorized Signatory",
"signature": {
"type": "drawn",
"url": "https://api.signatureapi.com/v1/uploads/upl_2bC6tF9gHk3LmQ8rSx5Vy7"
},
"mandate": "Authorized by Acme Corp board resolution 2026-04 (synthetic example)"
}
]
}
}{
"id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"title": "Account Agreement (sample)",
"label": null,
"message": "Please accept the terms and sign your account agreement.",
"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": null,
"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": [
"account_agreement"
]
},
"metadata": {
"application_id": "app_8841"
},
"sender": {
"name": "Acme Corp Legal",
"email": "legal@acme.example",
"organization": "Acme Corp"
},
"captures": {
"accepted_esign": false,
"accepted_terms": false
},
"documents": [
{
"id": "doc_HVl3Nj7XzTzX7jN3lVH5vn",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"key": "account_agreement",
"title": null,
"page_count": 1,
"url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
"format": "pdf",
"fixed_positions": [
{
"page": 1,
"top": 130,
"left": 210,
"place_key": "accept_terms"
},
{
"page": 1,
"top": 150,
"left": 210,
"place_key": "accept_esign"
},
{
"page": 1,
"top": 172,
"left": 210,
"place_key": "customer_signature"
},
{
"page": 1,
"top": 186,
"left": 220,
"place_key": "institution_countersignature"
}
],
"places": [
{
"key": "accept_terms",
"type": "checkbox",
"recipient_key": "customer",
"height": 20,
"symbol": "check",
"capture_as": "accepted_terms",
"requirement": "required"
},
{
"key": "accept_esign",
"type": "checkbox",
"recipient_key": "customer",
"height": 20,
"symbol": "check",
"capture_as": "accepted_esign",
"requirement": "required"
},
{
"key": "customer_signature",
"type": "signature",
"recipient_key": "customer",
"height": 60
},
{
"key": "institution_countersignature",
"type": "signature",
"recipient_key": "institution",
"height": 60
}
]
}
],
"recipients": [
{
"id": "re_HVl3Nj7XzTzX7jN3lVH5vn",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "signer",
"key": "customer",
"email": "jane.doe@example.com",
"name": "Jane Doe",
"ceremony": {
"authentication": [
{
"type": "email_link",
"subject_override": null,
"message_override": null
},
{
"type": "email_code"
}
],
"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": "automatic_signer",
"key": "institution",
"name": "Acme Corp Authorized Signatory",
"signature": {
"type": "drawn",
"url": "https://api.signatureapi.com/v1/uploads/upl_2bC6tF9gHk3LmQ8rSx5Vy7"
},
"initials": null,
"mandate": "Authorized by Acme Corp board resolution 2026-04 (synthetic example)",
"status": "awaiting",
"status_updated_at": "2026-11-02T14:03:11.000Z",
"completed_at": null
}
],
"topics": [
"fintech",
"account_opening"
],
"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.