Skip to main content
To use the Formable API, create an account, add an organization, then generate an API key. Optionally register a webhook to receive signing and redlining events.

​
Create an account

  1. Go to app.formabledocs.com/signup and create an account.
  2. Sign in at app.formabledocs.com.
  3. Open Settings.
Until you create an organization, API keys and webhooks stay locked.
Settings page showing an empty Organization section and disabled API keys and Webhooks actions

Settings before you create an organization. Generate key and Register webhook are disabled.

​
Create an organization

API keys, webhooks, and API resources belong to an organization. Each account can have one organization.
1

Open Create organization

In the Organization section, click Create organization.
2

Name your organization

Enter a name and click Create organization.
Create organization modal with Name set to Acme Inc

Name your organization in the Create organization dialog.

3

Confirm it appears in Settings

Your organization name and ID appear in Settings. Generate key and Register webhook become available.
Settings page showing Acme Inc organization with Generate key and Register webhook enabled

Settings after creating an organization. API keys and webhooks are unlocked.

​
Generate an API key

Use an API key as a Bearer token on every request. See Authentication for how to send it.
1

Generate a key

In the API keys section, click Generate key, enter a name, and confirm.
Generate API key modal with Name set to TestKeyName

Give the key a name you'll recognize later, then click Generate key.

2

Copy the key immediately

Formable shows the full key once. Copy it and store it before you click Done.
API key created modal showing a full fmbl_ key with a copy button

Copy the key now. For security purposes, after you close this dialog, only a short prefix remains visible.

Never expose API keys in browser or mobile code. Call the API from your backend.
You can rename or delete keys from the same page. Deleting a key revokes it immediately. Each account can have up to 10 active keys.

​
Register a webhook

Webhooks notify your app when documents are viewed, signed, or updated in a redline workflow. Each organization has one webhook URL. See Webhooks overview for delivery details.
1

Register a callback URL

In the Webhooks section, click Register webhook, enter an HTTPS callback URL, and confirm.
Register webhook modal with a Callback URL field

Enter the HTTPS URL that should receive events.

2

Save the signing secret

Copy the signing secret when it’s shown and store it as an environment secret. You’ll use it to verify webhooks. Formable does not show the secret again. You may rotate secrets if need be.
Webhook registered modal showing a signing secret with a copy button

Copy the signing secret before you click Done.

Production callback URLs must use https://. After registration you can edit the URL, rotate the secret, or delete the endpoint from the actions menu next to your webhook.

​
Next steps

Authentication

Send your API key on every request.

Quickstart

Create a signature request and get a signing URL.

Webhooks

Handle delivery, retries, and event payloads.

Core concepts

Learn how templates and signature requests fit together.