Back to API Overview

Integration Setup Tutorial

Everything you need before you can start sending documents for signature via the API.

Creating a Signing Template

Templates are reusable document structures. Your integration instantiates a template each time it sends a document, filling in recipients and field values via the API.

Important

Templates are user-scoped. The API can only access templates created by the integrator account. Log in as the integrator to create templates.

1. Go to Templates

Open Templates from the sidebar.

Templates page with search bar

2. Click Upload Template

Click Upload Template.

Template setup step two

3. Add a Signing Field

Add a signing field to the template.

Template setup step three

4. Save

Save the template.

Template setup step four

5. Copy Payload for Integration

Click the Copy Payload for Integration button on the template.

Template setup step five

Naming Your Fields

Give each field a clear, stable, developer-friendly label:

Good namesBad names
customer_nameText 1
contract_start_dateField 2
salary_amountInput

Labels are case-sensitive. Your API payload must match exactly.

Finding Your Template ID

After saving, note the template ID — visible in:

  • The URL bar when viewing the template
  • The API response from GET /api/templates in the integration sample app

Before Going Live

  • Every signer has at least one required signature field
  • All API-filled fields have clear, stable names
  • Recipient placeholder labels are final (changing them breaks API calls)
  • You've tested the template manually in the UI at least once
  • The template was created by the integrator account
⚠️
Renaming placeholders or field labels after going live breaks existing integrations. Clone the template before making changes.