This Exploration Agreement is entered into as of \{\{date}}, between \{\{serviceProvider.name}} of \{\{serviceProvider.organization}} (the "Service Provider") and \{\{client.name}} of \{\{client.organization}} (the "Client").
You can reference nested objects using dot notation: `{{serviceProvider.name}}` reads the `name` key inside the `serviceProvider` object.
To mark where signatures should appear, add `[[place_key]]` placeholders directly in the document. These work the same way as in PDF documents. In this example, the template contains the placeholders `[[provider_signs_here]]` and `[[client_signs_here]]`.
Please read before proceeding.
\{\{if showAlert}}
Important: This document is for demonstration purposes only and is not legally binding.
\{\{endif}} By signing, you acknowledge the terms above.
**Data:**
```json theme={null}
{
"showAlert": true
}
```
With `"showAlert": true`, the alert paragraph appears. With `"showAlert": false`, it is omitted entirely.
### If-Else
Use `{{if condition}}`, `{{else}}`, and `{{endif}}` to display one of two blocks depending on the value of a condition.
**Template:**
Important: This document is for demonstration purposes only and is not legally binding.
\{\{endif}} By signing, you acknowledge the terms above.
\{\{if mediation}}
Any dispute shall be resolved by mediation, with each party bearing its own costs.
\{\{else}}
Any dispute shall be settled by arbitration, and the arbitrator's decision is final.
\{\{endif}}
With `"mediation": true`:
Any dispute shall be resolved by mediation, with each party bearing its own costs.
\{\{else}}
Any dispute shall be settled by arbitration, and the arbitrator's decision is final.
\{\{endif}}
Any dispute shall be resolved by mediation, with each party bearing its own costs.
With `"mediation": false`:
Any dispute shall be settled by arbitration, and the arbitrator's decision is final.
## Try It
[Try this example in Postman](/docs/api/postman) using your [test API key](/docs/api/test-mode) to create a free, non-binding test envelope. Test envelopes won't send emails, but you can review them in your dashboard.
## Keep Learning
* Learn more about [document template syntax](/docs/api/resources/documents/templates), including all supported field and conditional options.
* Explore how to position signatures using [placeholders](/docs/api/guides/how-to/use-placeholders) or [fixed coordinates](/docs/api/guides/how-to/use-fixed-positions).
* Learn about other [types of places](/docs/api/resources/places/object), such as [initials](/docs/api/resources/places/initials), [text inputs](/docs/api/resources/places/text-input), or [completion dates](/docs/api/resources/places/date).
# Embed Signing in a Mobile App
Source: https://signatureapi-daf4ee54.mintlify.app/docs/api/guides/how-to/embed-mobile
Embed the SignatureAPI signing interface in your mobile app using a WebView
12/31/2025 11:59:59 PM
John Doe (#7161cf07) has been authenticated by SuperApp:
Session ID: a4f9e8b2-7c1d-4b2d-9a4b-e0c5d6f7a1b3
Order Reference: 25005
Authenticated At: Dec 31, 2025 23:59:59
Authentication Method: SMS
Phone Number: +1-111-1111111
IP Address: 100.100.100.100
As provided by the initiator of the electronic signature transaction.
12/31/2025 11:59:59 PM
John Doe (#7161cf07) has authenticated using a verification code sent to john@example.com.
12/31/2025 11:59:59 PM
John Doe (#7161cf07) has authenticated using a secure link sent to john@example.com.
With **email link authentication**, the recipient receives an email with a direct link to the ceremony. Clicking the link authenticates the recipient and opens the signing session.
With **email code authentication**, the recipient receives an email from SignatureAPI containing a 9-digit code. The recipient must enter this code to authenticate and access the ceremony.
With **custom authentication**, your application authenticates the recipient. SignatureAPI provides a ceremony URL that you share or embed in your application to give the recipient access.
With **email link authentication**, the recipient receives an email with a direct link to the ceremony. Clicking the link authenticates the recipient and opens the signing session.
With **email code authentication**, the recipient receives an email from SignatureAPI containing a 9-digit code. The recipient must enter this code to authenticate and access the ceremony.
With **custom authentication**, your application authenticates the recipient. SignatureAPI provides a ceremony URL that you share or embed in your application to give the recipient access.
This agreement is entered into by \{\{name}}.
**Data:**
```json theme={null}
{
"name": "Sherlock Holmes"
}
```
**Result:**
This agreement is entered into by Sherlock Holmes.
### Nested objects
Data values can be nested objects. Use dot notation in the template to reference nested keys.
**Template:**
This agreement is entered into by \{\{person.name}}, residing at \{\{person.address.houseNumber}} \{\{person.address.streetName}}, \{\{person.address.city}}.
**Data:**
```json theme={null}
{
"person": {
"name": "Sherlock Holmes",
"address": {
"houseNumber": "221b",
"streetName": "Baker Street",
"city": "London"
}
}
}
```
**Result:**
This agreement is entered into by Sherlock Holmes, residing at 221b Baker Street, London.
## Conditionals
Conditionals control which sections appear in the final document based on your data.
### If
Use `{{if condition}}` and `{{endif}}` to show or hide a block of content.
**Template:**
Please read before proceeding.
\{\{if showDisclaimer}}
Information provided is for educational purposes only and should not be considered as professional advice.
\{\{endif}} Use at your own discretion.
With `"showDisclaimer": true`, the disclaimer appears. With `"showDisclaimer": false`, it is omitted.
### If-Else
Use `{{if condition}}`, `{{else}}`, and `{{endif}}` to display one of two blocks based on a condition.
**Template:**
Information provided is for educational purposes only and should not be considered as professional advice.
\{\{endif}} Use at your own discretion.
\{\{if mediation}}
Any dispute shall be resolved by mediation, with each party bearing its own costs.
\{\{else}}
Any dispute shall be settled by arbitration, and the arbitrator's decision is final.
\{\{endif}}
With `"mediation": true`:
Any dispute shall be resolved by mediation, with each party bearing its own costs.
\{\{else}}
Any dispute shall be settled by arbitration, and the arbitrator's decision is final.
\{\{endif}}
Any dispute shall be resolved by mediation, with each party bearing its own costs.
With `"mediation": false`:
Any dispute shall be settled by arbitration, and the arbitrator's decision is final.
# Document URL and Upload
Source: https://signatureapi-daf4ee54.mintlify.app/docs/api/resources/documents/url
Upload PDF or DOCX files via the dashboard, API, or external storage like S3 or Azure
Every document in an envelope requires a `url` pointing to a PDF or DOCX file. SignatureAPI downloads the file when the envelope is created.
There are three ways to provide a file URL:
* [Upload via the Dashboard](#upload-via-dashboard)
* [Upload via the API](#upload-via-api)
* [Host it externally](#external-store) on a service like S3 or Azure
## Upload via Dashboard
Upload files to your account's **Library** in the Dashboard. Library files never expire and can be reused across multiple envelopes. This method works well for recurring documents and templates.
To upload a file, go to the **Library** tab in the Dashboard.
With **email link authentication**, the recipient receives an email with a direct link to the ceremony. Clicking the link authenticates the recipient and opens the signing session.
With **email code authentication**, the recipient receives an email from SignatureAPI containing a 9-digit code. The recipient must enter this code to authenticate and access the ceremony.
With **custom authentication**, your application authenticates the recipient. SignatureAPI provides a ceremony URL that you share or embed in your application to give the recipient access.
With **email link authentication**, the recipient receives an email with a direct link to the ceremony. Clicking the link authenticates the recipient and opens the signing session.
With **email code authentication**, the recipient receives an email from SignatureAPI containing a 9-digit code. The recipient must enter this code to authenticate and access the ceremony.
With **custom authentication**, your application authenticates the recipient. SignatureAPI provides a ceremony URL that you share or embed in your application to give the recipient access.
With **email link authentication**, the recipient receives an email with a direct link to the ceremony. Clicking the link authenticates the recipient and opens the signing session.
With **email code authentication**, the recipient receives an email from SignatureAPI containing a 9-digit code. The recipient must enter this code to authenticate and access the ceremony.
With **custom authentication**, your application authenticates the recipient. SignatureAPI provides a ceremony URL that you share or embed in your application to give the recipient access.
With **email link authentication**, the recipient receives an email with a direct link to the ceremony. Clicking the link authenticates the recipient and opens the signing session.
With **email code authentication**, the recipient receives an email from SignatureAPI containing a 9-digit code. The recipient must enter this code to authenticate and access the ceremony.
With **custom authentication**, your application authenticates the recipient. SignatureAPI provides a ceremony URL that you share or embed in your application to give the recipient access.
With **email link authentication**, the recipient receives an email with a direct link to the ceremony. Clicking the link authenticates the recipient and opens the signing session.
With **email code authentication**, the recipient receives an email from SignatureAPI containing a 9-digit code. The recipient must enter this code to authenticate and access the ceremony.
With **custom authentication**, your application authenticates the recipient. SignatureAPI provides a ceremony URL that you share or embed in your application to give the recipient access.
With **email link authentication**, the recipient receives an email with a direct link to the ceremony. Clicking the link authenticates the recipient and opens the signing session.
With **email code authentication**, the recipient receives an email from SignatureAPI containing a 9-digit code. The recipient must enter this code to authenticate and access the ceremony.
With **custom authentication**, your application authenticates the recipient. SignatureAPI provides a ceremony URL that you share or embed in your application to give the recipient access.
With **email link authentication**, the recipient receives an email with a direct link to the ceremony. Clicking the link authenticates the recipient and opens the signing session.
With **email code authentication**, the recipient receives an email from SignatureAPI containing a 9-digit code. The recipient must enter this code to authenticate and access the ceremony.
With **custom authentication**, your application authenticates the recipient. SignatureAPI provides a ceremony URL that you share or embed in your application to give the recipient access.
This Dummy Agreement is entered into by \{\{person.name}}, currently residing at \{\{person.address}}. The terms and conditions outlined in this agreement shall be governed by the laws of \{\{jurisdiction}}.
\{\{if mediation}}
Any dispute shall be resolved by mediation, with each party bearing its own costs.
\{\{else}}
Any dispute shall be settled by arbitration, and the arbitrator's decision is final.
\{\{endif}}
When data is inserted:
Any dispute shall be resolved by mediation, with each party bearing its own costs.
\{\{else}}
Any dispute shall be settled by arbitration, and the arbitrator's decision is final.
\{\{endif}}
This Dummy Agreement is entered into by Sherlock Holmes, currently residing at 221b Baker Street, London. The terms and conditions outlined in this agreement shall be governed by the laws of The United Kingdom.
Any dispute shall be settled by arbitration, and the arbitrator's decision is final.
## Fields
Fields are markers within a template that indicate where specific information should be inserted. They are defined within your template with **double curly braces**, for example: `{{name}}`.
For example, a template:
This Dummy Agreement is entered into by \{\{name}}.
With data:
This Dummy Agreement is entered into by Sherlock Holmes.
### Nested objects
You can use nested objects in the data value. For example, a template:
This Dummy Agreement is entered into by \{\{person.name}}, currently residing at \{\{person.address.houseNumber}} \{\{person.address.streetName}}, \{\{person.address.city}}.
With a data value:
This Dummy Agreement is entered into by Sherlock Holmes, currently residing at 221b Baker Street, London.
## Conditionals
Conditionals in templates allow for the inclusion or exclusion of content based on certain conditions.
### If
You can use `{{if Condition}}` and `{{endif}}` to show or hide the content in between, depending on whether `Condition` is true or not.
For example, a template:
Please read before proceeding.
\{\{if showDisclaimer}}
Information provided is for educational purposes only and should not be considered as professional advice.
\{\{endif}} Use at your own discretion.
With the data value:
Information provided is for educational purposes only and should not be considered as professional advice.
\{\{endif}} Use at your own discretion.
Please read before proceeding.
Information provided is for educational purposes only and should not be considered as professional advice.
Use at your own discretion.
But with the data value:
Information provided is for educational purposes only and should not be considered as professional advice.
Use at your own discretion.
Please read before proceeding.
Use at your own discretion.
### If-Else
You can use `{{if Condition}}`, `{{else}}`, and `{{endif}}` to conditionally display content based on whether `Condition` is true or false."
For example, a template:
\{\{if mediation}}
Any dispute shall be resolved by mediation, with each party bearing its own costs.
\{\{else}}
Any dispute shall be settled by arbitration, and the arbitrator’s decision is final.
\{\{endif}}
With data:
Any dispute shall be resolved by mediation, with each party bearing its own costs.
\{\{else}}
Any dispute shall be settled by arbitration, and the arbitrator’s decision is final.
\{\{endif}}
Any dispute shall be resolved by mediation, with each party bearing its own costs.
But with data:
Any dispute shall be settled by arbitration, and the arbitrator’s decision is final.
# Captures
Source: https://signatureapi-daf4ee54.mintlify.app/docs/integrations/power-automate/envelopes/captures
Access data entered by recipients during signing ceremonies in Power Automate flows
Some types of [places](/docs/integrations/power-automate/places/place) allow [recipients](/docs/integrations/power-automate/recipients/recipient) to enter data during the ceremony, such as [text input places](/docs/integrations/power-automate/places/text-input). The content entered in these places is rendered on the documents once the recipients complete their participation. In some cases, you may also want to access this input data via the API.
You can use **Captures** to store values entered by recipients during the ceremony.
## Defining Captures
Places that allow arbitrary recipient input (like text input places) have a **Capture As** property. This property lets you define a key to identify the captured value within the envelope.
Customer Agreement Form
Please fill out the form below. We'll use this information to generate or request a customer agreement.