🔐 API Authentication – Setting Up Your x-api-token
To authenticate and use OpenSign API endpoints, you’ll need a valid API token (x-api-token
).
Follow the steps below to generate one.
Note: You can generate both Live and Sandbox API tokens from your OpenSign account.
🧭 Step-by-Step Guide to Generate Your API Token
Step 1: Log in to your OpenSign account using valid credentials.
Step 2: Navigate to the Settings section and click on API Token.
Step 3: On the API Token page, click the Generate Live API Token button.
Note: To generate a Live API Token, you must upgrade to a paid plan — either the Professional or Teams plan.
- Your
x-api-token
will now be generated and displayed. - Copy this token — you’ll need it to authenticate your OpenSign API requests.
🧪 Sandbox API Token
You’ll also find the option to generate a Sandbox API Token on the same page.
- Sandbox API tokens are available on all plans, including the free plan, and are intended for development and testing.
- Do not upload confidential data to the Sandbox environment.
🧠 Frequently Asked Questions
1. What is the OpenSign Sandbox environment?
The Sandbox is a testing environment designed for developers to safely experiment with OpenSign APIs and workflows. It mirrors the live environment but with certain limitations.
2. Can I upload large documents to the Sandbox?
No. Please avoid uploading documents larger than 5MB in the Sandbox. It is optimized for lightweight testing only.
3. Can I use my Live API Token in the Sandbox?
No. Live API Tokens do not work in the Sandbox environment. You’ll need to generate a separate token specifically for Sandbox testing.
4. Why can’t I use a live template in the Sandbox?
Live and Sandbox environments are separate. Templates created in the Live environment cannot be used in the Sandbox, and vice versa.
5. Can I use the API in the free self-hosted environment?
No. The free self-hosted version does not support API token generation.
To use OpenSign APIs in a self-hosted setup, you must upgrade to a paid self-hosted plan.
If you need additional assistance setting up OpenSign APIs, feel free to contact our support team at support@opensignlabs.com.