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

# Authentication

> Create your organization, verify your identity, and get your API key to start building with Agni.

Welcome to Agni. To start building production-grade voice AI agents, you need an active workspace. This guide covers how to register your organization, verify your identity, generate API keys, and manage access.

***

## Create an Account

The creation process registers a new Agni organization and sets up your initial administrator account.

<Frame>
  <img src="https://mintcdn.com/agni/8PpPPRdkG6EoAQMg/images/auth-create-account.png?fit=max&auto=format&n=8PpPPRdkG6EoAQMg&q=85&s=88cefc89c608f88fc53b463583d628dc" alt="Agni Create Account Page" width="1243" height="940" data-path="images/auth-create-account.png" />
</Frame>

### Registration Steps

<Steps>
  <Step title="Navigate to Sign Up" icon="browser">
    Open the [Agni Web App](https://app.ravan.ai) and click **Create an account**.
  </Step>

  <Step title="Choose Authentication Method" icon="shield-keyhole">
    You can securely click **Sign up with Google** for single sign-on (which bypasses manual email verification), or proceed with a standard email registration.
  </Step>

  <Step title="Enter Organization, Personal & Contact Details" icon="building-user">
    If using email, provide your **Organization Name**, **First Name**, **Last Name**, and **Phone Number** with the correct country code. Your organization acts as the top-level container for your agents, phone numbers, and billing. [Know more about organizations](/guides/organizations-and-roles).
  </Step>

  <Step title="Set Credentials" icon="lock">
    Enter a valid work **Email**, a secure **Password** (minimum 8 characters), and select how you heard about Agni, then click **Create account**.
  </Step>

  <Step title="Verify Your Email" icon="envelope-circle-check">
    If you registered via email, you will be redirected to the verification screen. Check your inbox for an email from Agni AI.

    <Frame>
      <img src="https://mintcdn.com/agni/wGEXRTXXwORCEgLm/images/auth-verify-screen.png?fit=max&auto=format&n=wGEXRTXXwORCEgLm&q=85&s=a3d2e76896f3e8ec0245b6f24a94ff53" alt="Email Verification Screen" width="527" height="568" data-path="images/auth-verify-screen.png" />
    </Frame>

    You can either click the **Verify Account** button directly in the email, or copy the 6-digit code provided and enter it manually into the verification screen.

    <Note>
      Verification codes are only valid for 10 minutes. If your code expires or you do not receive the email, click **Didn't receive the code? Resend** on the verification screen.
    </Note>
  </Step>

  <Step title="Complete Registration" icon="check">
    Once verified, you will be routed directly to your new workspace dashboard.
  </Step>
</Steps>

<Note>
  If your email is already registered to an existing workspace, Agni will prompt you to sign in instead.
</Note>

***

## Log In

Access your existing Agni workspace to manage agents, configure telephony, and retrieve your API keys.

<Frame>
  <img src="https://mintcdn.com/agni/wGEXRTXXwORCEgLm/images/auth-login.png?fit=max&auto=format&n=wGEXRTXXwORCEgLm&q=85&s=2c266cffaa1ba9d4b242ac18f2c5bca5" alt="Agni Login Page" width="1919" height="1079" data-path="images/auth-login.png" />
</Frame>

### Sign In Steps

<Steps>
  <Step title="Navigate to Login" icon="arrow-right-to-bracket">
    Open the [Agni Login Page](https://app.ravan.ai/login).
  </Step>

  <Step title="Authenticate" icon="fingerprint">
    Click **Continue with Google** if your account is linked to Google Workspace, or enter your registered **Email** and **Password**.
  </Step>

  <Step title="Access Workspace" icon="door-open">
    Click **Sign in** to access your dashboard.
  </Step>
</Steps>

<Note>
  If you lose access to your account, use the **Forgot?** link above the password field to initiate a secure password reset workflow.
</Note>

***

## Generate an API Key

To interact with Agni programmatically, you need an API key. Here's how to create one:

<Steps>
  <Step title="Open Settings" icon="gear">
    Click your profile in the bottom-left corner of the dashboard, then select **Settings**.
  </Step>

  <Step title="Navigate to API Keys" icon="key">
    In the Settings menu, click the **API Keys** tab under **Security & Access**.
  </Step>

  <Step title="Create a New Key" icon="plus">
    Click **+ New Key**. Your API key will be generated and displayed once. Copy it immediately.
  </Step>

  <Step title="Store it Securely" icon="vault">
    Save the key in a secure location (e.g., environment variable, secrets manager). You will not be able to view it again after closing the dialog.
  </Step>
</Steps>

<Warning>
  Never expose your API key in client-side code, public repositories, or browser-accessible files. Treat it like a password.
</Warning>

### Using Your API Key

Pass the key in the `X-Api-Key` header with every API request:

```bash theme={null}
curl https://api.ravan.ai/api/v1/agents/ \
  -H "X-Api-Key: YOUR_API_KEY"
```

***

## Next Steps

<div className="auth-next-steps">
  <CardGroup cols={2}>
    <Card title="API Reference" icon="code" href="/api-reference/introduction">
      Full REST API documentation with request examples in cURL, Python, and JavaScript.
    </Card>

    <Card title="Create an Agent" icon="robot" href="/guides/agents">
      Build and deploy your first real-time voice AI agent.
    </Card>

    <Card title="Set Up Telephony" icon="phone" href="/guides/phone-numbers">
      Buy a phone number and connect it to your agent.
    </Card>

    <Card title="Workspace Settings" icon="gear" href="/guides/settings">
      Configure your organization, invite team members, and connect integrations.
    </Card>
  </CardGroup>
</div>