Articles in this section
Category / Section

Choosing between create template vs. embedded template in BoldSign

Published:
1 min read

In BoldSign, both Create template and Embedded template are used to build reusable eSignature templates but they have some key differences and use cases:

1. Create template – Backend automation

This method is ideal for automated workflows, as it creates templates directly through the BoldSign API without requiring any user interaction.

  • Purpose: Automate template creation via backend processing
  • API Endpoint: POST /v1/template/create
  • User Experience: No UI interaction
  • Use Case:
    • Auto-create loan agreements
    • Onboarding forms
    • Claims or policy documents
  • Form Field Configuration:
    • Fields must be defined programmatically
    • Developers specify field type, position, page number, and recipient via code

Here is an example Python script for the create template API

Python template send

2. Embedded template – In-app user control

This method allows users to create and customize templates from within your app using BoldSign’s embedded UI.

  • Purpose: Enable users to create templates interactively
  • API Endpoint: POST /v1/template/createEmbeddedTemplateUrl
  • User Experience: UI embedded via iframe, popup, or new tab
  • Use Case:
    • HR platforms
    • Real estate or legal apps
    • SaaS tools with user-facing workflows
  • Form Field Configuration:
    • Users can drag and drop form fields like signature boxes, text inputs, and checkboxes
    • No coding required—fields are placed visually within the embedded interface.

The screenshot below shows template creation embedded within an iFrame.

Embedded template

Summary table: Key differences

Feature Send template Embedded template
Purpose Backend automation In-app template preparation
API Endpoint /v1/template/create /v1/template/createEmbeddedTemplateUrl
Template State created immediately Draft until user creates
URL No Yes – embeddable for users
User Interaction None Full control via embedded UI
Form Field Setup Defined via API code Drag-and-drop via embedded UI
Customization Via code visual customization by user
Tagging templates Via code Manual tagging in UI
Recipient Management Automated Editable by user

Which should you choose?

  • Choose Create template for speed, scale, and backend automation.
  • Choose Embedded template for user control, customization and interactive workflows.
Was this article useful?
Like
Dislike
Help us improve this page
Please provide feedback or comments
Access denied
Access denied