Skip to content

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_link then email_code. The customer needs the emailed link and a code from a separate email. See Multiple authentication methods.
  • Automatic countersignature. The institution recipient is an automatic_signer with an uploaded signature image and a mandate that records your authority to sign. It has no email and no ceremony. See Automatic signer and Uploads.
  • Two required checkboxes. accepted_terms and accepted_esign must be checked, and each value is stored in captures through capture_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

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.

Default
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)"
    }
  ]
}
{
  "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
}

Errors every call can return are in Errors and Authentication.