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

# Get an API Key

> Create a Webacy Developer Portal account, generate an API key, and rotate or revoke keys using the interim workflow until self-service ships.

To start using the Webacy DD APIs, you’ll need an API key associated with your account.

Your API key authenticates requests to Webacy and determines which products, usage limits, and environments your account can access.

<Steps>
  <Step title="Create an account">
    Create an account on our [Developer Portal](https://developers.webacy.co/) or sign in to your existing account.

    <Info>
      The Developer Portal requires a work or organization email address to register. Personal addresses such as Gmail, Yahoo, or Outlook are rejected during sign-up with the error `Please use your organization's email address to register. Personal email addresses are not permitted.` If you do not have an organization email, contact [info@webacy.com](mailto:info@webacy.com) to request access.
    </Info>

    <Frame>
      <img src="https://mintcdn.com/webacy/WOwccSluwNfjURJB/images/Screenshot-2026-07-30-at-4.43.06-PM.png?fit=max&auto=format&n=WOwccSluwNfjURJB&q=85&s=5d72c63efcfa4d10cd9e1adbe728cfcf" alt="Screenshot 2026 07 30 At 4 43 06 PM" title="Screenshot 2026 07 30 At 4 43 06 PM" style={{ width:"85%" }} width="2534" height="1250" data-path="images/Screenshot-2026-07-30-at-4.43.06-PM.png" />
    </Frame>
  </Step>

  <Step title="Navigate to API Keys">
    Once you are signed in, open the developer dashboard and navigate to **API Keys**.

    <Frame>
      <img src="https://mintcdn.com/webacy/WOwccSluwNfjURJB/images/Screenshot-2026-07-30-at-4.44.23-PM.png?fit=max&auto=format&n=WOwccSluwNfjURJB&q=85&s=9a8a2bce0acb05c2182a26e6639944c0" alt="Screenshot 2026 07 30 At 4 44 23 PM" title="Screenshot 2026 07 30 At 4 44 23 PM" style={{ width:"63%" }} width="962" height="476" data-path="images/Screenshot-2026-07-30-at-4.44.23-PM.png" />
    </Frame>
  </Step>

  <Step title="Generate your API key">
    From the **API Keys** page:

    1. Select **+ Generate API Key**.
    2. Securely store the generated key.

    <Frame>
      <img src="https://mintcdn.com/webacy/WOwccSluwNfjURJB/images/Screenshot-2026-07-30-at-4.47.49-PM.png?fit=max&auto=format&n=WOwccSluwNfjURJB&q=85&s=8f59d8ca9610face3f83ec1854eca079" alt="Screenshot 2026 07 30 At 4 47 49 PM" title="Screenshot 2026 07 30 At 4 47 49 PM" style={{ width:"75%" }} width="1532" height="538" data-path="images/Screenshot-2026-07-30-at-4.47.49-PM.png" />
    </Frame>
  </Step>

  <Step title="Start Testing!" />
</Steps>

<Warning>
  **Keep Your Key Secure!**

  Treat your API key like an important password.

  Do not:

  * expose it in browser-side code
  * commit it to a public repository
  * include it in screenshots, logs, or support messages
  * share the same production key across unrelated applications

  If your key is exposed, anyone can use your API key as you. You will be responsible for all usage costs, limits, and impact caused by the exposed API key.
</Warning>

<Tip>
  **Use Separate Keys for Each Environment**

  We recommend creating different keys for:

  * local development
  * staging
  * production
  * separate applications or internal teams

  This makes it easier to monitor usage, rotate compromised credentials, and revoke access without interrupting every integration.
</Tip>

## Rotate or revoke your key

Self-service rotation and revocation are not yet available in the Developer Portal (see the coming-soon list below). Until they ship, use the following interim workflow.

**To rotate a key:**

1. In the Developer Portal, open **API Keys** and select **+ Generate API Key** to create a new key.
2. Update every application, environment, and stored secret to use the new key.
3. Stop sending the old key. Requests with the old key continue to succeed until Webacy revokes it, so cut all traffic over before requesting revocation.

**To revoke a key, including any key you believe is compromised:**

1. Complete the rotation steps above so live traffic is on the new key.
2. Email [info@webacy.com](mailto:info@webacy.com) or use the [contact form](https://dapp.webacy.com/contact) with the key ID (never the full secret) and request revocation. Webacy revokes the key on your behalf.

<Warning>
  If a key is exposed, treat it as compromised. Rotate first so your integration keeps working, then request revocation immediately. The old key remains valid until Webacy revokes it.
</Warning>

<Card title="🚧 Under Construction 🚧" type="info">
  Our Developer Portal is currently under construction. 

  The following features are coming soon:

  * Rotate API Key
  * Revoke / Delete API Key
  * Create Multiple API Keys
  * Team Management 
  * RBAC

  Want additional features? [Contact Us](https://dapp.webacy.com/contact).
</Card>

## What's Next

<Card title="Authentication" icon="lock" horizontal href="/authentication">
  Learn how to authenticate your API requests
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.