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

# Inicio rápido

> De cero a tu primer request autenticado en menos de cinco minutos.

## 1. Crea una API key

1. Inicia sesión en tu organización de FlowEstate en [panel.flowestate.app](https://panel.flowestate.app).
2. Ve a **Configuración → API Keys**.
3. Haz clic en **Nueva API key**, ponle un nombre descriptivo (p.ej. `make-lead-ingest`), y selecciona los scopes que necesitas. La mayoría de los casos "enviar leads desde un formulario" solo necesitan `leads:write`.
4. Copia la key — empieza con `fe_k_`. <Warning>La key completa se muestra solo una vez. Si la pierdes, revócala y crea una nueva.</Warning>

## 2. Prueba la key

El endpoint `/me` no requiere ningún scope y es la prueba más segura:

<CodeGroup>
  ```bash curl theme={null}
  curl https://panel.flowestate.app/api/v1/me \
    -H "Authorization: Bearer fe_k_tu_key_aqui"
  ```

  ```js Node.js theme={null}
  const res = await fetch("https://panel.flowestate.app/api/v1/me", {
    headers: { Authorization: "Bearer fe_k_tu_key_aqui" },
  });
  console.log(await res.json());
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      "https://panel.flowestate.app/api/v1/me",
      headers={"Authorization": "Bearer fe_k_tu_key_aqui"},
  )
  print(res.json())
  ```
</CodeGroup>

Deberías ver el nombre de tu organización y los scopes asociados a la key:

```json theme={null}
{
  "organization": { "id": "org_...", "name": "Acme Realty", "slug": "acme-realty" },
  "auth": { "type": "api_key", "scopes": ["leads:write"], "clientId": null, "userId": null }
}
```

## 3. Crea tu primer lead

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://panel.flowestate.app/api/v1/leads \
    -H "Authorization: Bearer fe_k_tu_key_aqui" \
    -H "Content-Type: application/json" \
    -d '{
      "firstName": "Ada",
      "lastName": "Lovelace",
      "email": "ada@example.com",
      "source": "website"
    }'
  ```

  ```js Node.js theme={null}
  const res = await fetch("https://panel.flowestate.app/api/v1/leads", {
    method: "POST",
    headers: {
      Authorization: "Bearer fe_k_tu_key_aqui",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      firstName: "Ada",
      lastName: "Lovelace",
      email: "ada@example.com",
      source: "website",
    }),
  });
  console.log(await res.json());
  ```

  ```python Python theme={null}
  import requests

  res = requests.post(
      "https://panel.flowestate.app/api/v1/leads",
      headers={
          "Authorization": "Bearer fe_k_tu_key_aqui",
          "Content-Type": "application/json",
      },
      json={
          "firstName": "Ada",
          "lastName": "Lovelace",
          "email": "ada@example.com",
          "source": "website",
      },
  )
  print(res.json())
  ```
</CodeGroup>

Una respuesta `201 Created` con el `id` del lead nuevo significa que todo está bien conectado. Abre la vista de **Leads** en tu panel — Ada debería aparecer ahí.

<Note>Al menos uno de `email` o `phone` es requerido. Las cadenas vacías cuentan como ausentes. Ver [Crear un lead](/es/api-reference/leads#crear-un-lead) para el payload completo.</Note>

## 4. Siguientes pasos

* [Autentícate correctamente](/es/authentication) y entiende los [scopes](/es/scopes).
* Aprende cómo aparecen los [errores](/es/errors) y los [límites de tasa](/es/rate-limits) en las respuestas.
* Suscríbete a [webhooks](/es/webhooks) para que tus otros sistemas reaccionen cuando algo cambie en FlowEstate.