> ## Documentation Index
> Fetch the complete documentation index at: https://docs.formabledocs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up a developer account

> Create a Formable account, organization, API keys, and webhooks so you can call the API: all in less than 5 minutes.

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](https://app.formabledocs.com/signup) and create an account.
2. Sign in at [app.formabledocs.com](https://app.formabledocs.com).
3. Open [Settings](https://app.formabledocs.com/settings).

Until you create an organization, API keys and webhooks stay locked.

<Frame caption="Settings before you create an organization. Generate key and Register webhook are disabled.">
  <img src="https://mintcdn.com/formable/JCFo3k5HYZzZUnaw/static/images/dev-settings/SettingsPreOrgCreation.png?fit=max&auto=format&n=JCFo3k5HYZzZUnaw&q=85&s=2c65e74996eba7dc17f800585a0cfd53" alt="Settings page showing an empty Organization section and disabled API keys and Webhooks actions" width="2256" height="1664" data-path="static/images/dev-settings/SettingsPreOrgCreation.png" />
</Frame>

## Create an organization

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

<Steps>
  <Step title="Open Create organization">
    In the **Organization** section, click **Create organization**.
  </Step>

  <Step title="Name your organization">
    Enter a name and click **Create organization**.

    <Frame caption="Name your organization in the Create organization dialog.">
      <img src="https://mintcdn.com/formable/JCFo3k5HYZzZUnaw/static/images/dev-settings/SettingsMidOrgCreation.png?fit=max&auto=format&n=JCFo3k5HYZzZUnaw&q=85&s=a76b21d29fbce5f0a9b21d70d7efdcde" alt="Create organization modal with Name set to Acme Inc" width="2260" height="1736" data-path="static/images/dev-settings/SettingsMidOrgCreation.png" />
    </Frame>
  </Step>

  <Step title="Confirm it appears in Settings">
    Your organization name and ID appear in Settings. **Generate key** and **Register webhook** become available.

    <Frame caption="Settings after creating an organization. API keys and webhooks are unlocked.">
      <img src="https://mintcdn.com/formable/JCFo3k5HYZzZUnaw/static/images/dev-settings/SettingsPostOrgCreation.png?fit=max&auto=format&n=JCFo3k5HYZzZUnaw&q=85&s=81f0a84419d0f4bfb386a32a2a5c0ab6" alt="Settings page showing Acme Inc organization with Generate key and Register webhook enabled" width="2570" height="1750" data-path="static/images/dev-settings/SettingsPostOrgCreation.png" />
    </Frame>
  </Step>
</Steps>

## Generate an API key

Use an API key as a Bearer token on every request. See [Authentication](/authentication) for how to send it.

<Steps>
  <Step title="Generate a key">
    In the **API keys** section, click **Generate key**, enter a name, and confirm.

    <Frame caption="Give the key a name you'll recognize later, then click Generate key.">
      <img src="https://mintcdn.com/formable/JCFo3k5HYZzZUnaw/static/images/dev-settings/SettingsMidApiKeyCreation.png?fit=max&auto=format&n=JCFo3k5HYZzZUnaw&q=85&s=64d21f1e4d22e17a3d45d1c0ea8afb9e" alt="Generate API key modal with Name set to TestKeyName" width="2032" height="1736" data-path="static/images/dev-settings/SettingsMidApiKeyCreation.png" />
    </Frame>
  </Step>

  <Step title="Copy the key immediately">
    Formable shows the full key once. Copy it and store it before you click **Done**.

    <Frame caption="Copy the key now. For security purposes, after you close this dialog, only a short prefix remains visible.">
      <img src="https://mintcdn.com/formable/JCFo3k5HYZzZUnaw/static/images/dev-settings/SettingsApiKeyDisplayed.png?fit=max&auto=format&n=JCFo3k5HYZzZUnaw&q=85&s=f3d49176413687109c03d80abd54a93c" alt="API key created modal showing a full fmbl_ key with a copy button" width="2036" height="1734" data-path="static/images/dev-settings/SettingsApiKeyDisplayed.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Never expose API keys in browser or mobile code. Call the API from your backend.
</Warning>

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](/webhooks/overview) for delivery details.

<Steps>
  <Step title="Register a callback URL">
    In the **Webhooks** section, click **Register webhook**, enter an HTTPS callback URL, and confirm.

    <Frame caption="Enter the HTTPS URL that should receive events.">
      <img src="https://mintcdn.com/formable/JCFo3k5HYZzZUnaw/static/images/dev-settings/SettingsMidWebhookCreation.png?fit=max&auto=format&n=JCFo3k5HYZzZUnaw&q=85&s=65deec1a4f9a02c11e1dc89f2f0554f5" alt="Register webhook modal with a Callback URL field" width="2036" height="1722" data-path="static/images/dev-settings/SettingsMidWebhookCreation.png" />
    </Frame>
  </Step>

  <Step title="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](/webhooks/verifying-webhooks). Formable does not show the secret again. You may rotate secrets if need be.

    <Frame caption="Copy the signing secret before you click Done.">
      <img src="https://mintcdn.com/formable/JCFo3k5HYZzZUnaw/static/images/dev-settings/SettingsWebhookSecretDisplayed.png?fit=max&auto=format&n=JCFo3k5HYZzZUnaw&q=85&s=0674d4f05845c7889146f0f3fef0d410" alt="Webhook registered modal showing a signing secret with a copy button" width="2034" height="1734" data-path="static/images/dev-settings/SettingsWebhookSecretDisplayed.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  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.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Send your API key on every request.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Create a signature request and get a signing URL.
  </Card>

  <Card title="Webhooks" icon="bell" href="/webhooks/overview">
    Handle delivery, retries, and event payloads.
  </Card>

  <Card title="Core concepts" icon="book" href="/concepts">
    Learn how templates and signature requests fit together.
  </Card>
</CardGroup>
