---
title: "Test Mode"
description: "Build and test with free, non-binding SignatureAPI test envelopes: no emails reach recipients, documents carry a watermark, and switching to live is one key."
canonical: "https://signatureapi.com/docs/api/test-mode"
source: "https://signatureapi.com/docs/api/test-mode.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T11:48:47Z"
---

# Test Mode

Build and test with free, non-binding SignatureAPI test envelopes: no emails reach recipients, documents carry a watermark, and switching to live is one key.

_Last verified against API version 1.18.0._

When you sign up for SignatureAPI, you get a free test API key. Test API keys let you create test envelopes, great for trying out your workflows.

The API key decides the mode. Each mode has its own envelopes, webhook endpoints, and senders:

**Test mode and live mode**

Parts:

- **key_test_ key** (Test mode): One per account. Free to use.
- **Test envelope** (Test mode): No emails sent: preview them in the Dashboard. Documents carry a watermark and are not billed.
- **Test endpoints** (Test mode): Receive events from test envelopes only.
- **key_live_ key** (Live mode): Needs an active paid plan.
- **Live envelope** (Live mode): Emails go to real recipients. Legally binding and billed.
- **Live endpoints** (Live mode): Receive events from live envelopes only.

Connections:

- key_test_ key to Test envelope: creates
- Test envelope to Test endpoints: events
- key_live_ key to Live envelope: creates
- Live envelope to Live endpoints: events

## Test envelopes don't send emails

Don't be afraid of flooding your customer's inboxes with test emails. Emails from test envelopes don't get sent to recipients. But, you can inspect them in your [Dashboard's Email view](https://dashboard.signatureapi.com/emails?mode=test).

![Dashboard Emails page with Test Mode on, a notice that only test-mode emails are shown, and a list of emails with recipient, subject and sent time](https://signatureapi.com/docs/images/test-email-section.webp)

*Emails, with Test Mode on*

Where you can see the email contents:

![Detail of a test email in the Dashboard: sent time, subject, recipient, sender and envelope on the left, and the rendered email content on the right](https://signatureapi.com/docs/images/test-email-detail.webp)

*Email detail*

## Test envelopes are not legally-binding

A notice watermark on documents in test envelopes makes them non-binding.

![Top of a test document in the signing ceremony, with the notice NULL AND VOID, NON-BINDING TEST DOCUMENT in red](https://signatureapi.com/docs/images/test-watermark.webp)

*The test-mode notice on every page*

## Test envelopes are free

We don't bill you for test envelopes.

## Test mode and live mode differences

|                 | Test mode                                                                                         | Live mode                                                                                         |
| --------------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| API key prefix  | `key_test_`                                                                                       | `key_live_`                                                                                       |
| Emails sent     | No. Preview in [Dashboard](https://dashboard.signatureapi.com/emails?mode=test).                  | Yes, to real recipients.                                                                          |
| Legally binding | No. Documents show a watermark.                                                                   | Yes.                                                                                              |
| Billing         | Free                                                                                              | Counted toward your plan.                                                                         |
| Webhooks        | Delivered to [test endpoints](https://signatureapi.com/docs/api/webhooks#test-and-live-endpoints) | Delivered to [live endpoints](https://signatureapi.com/docs/api/webhooks#test-and-live-endpoints) |

You can use test mode and live mode at the same time. They are independent: test envelopes, webhooks, and senders are separate from live ones.

## Switch to live mode

When you are ready to start sending legally-binding envelopes, go to the API Key section of your [Dashboard](https://dashboard.signatureapi.com). Follow the instructions to create a live API key.

Live keys need an active paid plan. If your account has no plan yet, subscribe to one in [billing settings](https://dashboard.signatureapi.com/settings/billing) first.

Replace `key_test_` with your new `key_live_` key in your API calls. No other code changes are needed.

Before you send live envelopes, check the rest of your integration:

**Go-live checklist**

- [ ] [Create a live API key](https://signatureapi.com/docs/api/test-mode#switch-to-live-mode): Live keys start with `key_live_`. Replace `key_test_` with it in your API calls; no other code changes are needed.
- [ ] [Keep the API key on your server](https://signatureapi.com/docs/embedded/introduction#client-side): Never call the API from the client: anyone with your key can access all your data in SignatureAPI.
- [ ] [Register webhook endpoints for live mode](https://signatureapi.com/docs/api/webhooks): Test and live mode are independent: live events go only to live endpoints, and test envelopes, webhooks and senders are separate from live ones.
- [ ] [Verify webhook signatures](https://signatureapi.com/docs/api/webhooks#authentication): Check the HMAC signature in the `webhook-signature` header with the endpoint's signing secret, following the Standard Webhooks specification.
- [ ] [Answer every webhook with a `2XX` status](https://signatureapi.com/docs/api/webhooks#retries): Any other status counts as a failed delivery. SignatureAPI retries for up to 48 hours with exponential backoff.
- [ ] [Handle events that arrive out of order](https://signatureapi.com/docs/api/webhooks#event-delivery): SignatureAPI does not guarantee the order of event delivery.
- [ ] [Retry `429` responses with backoff](https://signatureapi.com/docs/api/rate-limiting): Wait 1 second, then double the wait time after each `429` response.
- [ ] [Confirm ceremony outcomes on your server](https://signatureapi.com/docs/embedded/ceremony-events#confirm-the-outcome-on-your-server): A ceremony event is a UI signal, not proof. Read the envelope or use a webhook before acting on `ceremony.completed`.
- [ ] [Review your branding](https://signatureapi.com/docs/api/resources/envelopes/branding): Check the logo, colors and emails recipients will see.
