Inicio rápido

1. Crea una API key

Inicia sesión en tu organización de FlowEstate en panel.flowestate.app.
Ve a Configuración → API Keys.
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.
Copia la key — empieza con fe_k_.
La key completa se muestra solo una vez. Si la pierdes, revócala y crea una nueva.

2. Prueba la key

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

curl https://panel.flowestate.app/api/v1/me \
  -H "Authorization: Bearer fe_k_tu_key_aqui"

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

import requests

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

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

{
  "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

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"
  }'

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());

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())

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í.

Al menos uno de email o phone es requerido. Las cadenas vacías cuentan como ausentes. Ver Crear un lead para el payload completo.

4. Siguientes pasos

Autentícate correctamente y entiende los scopes.
Aprende cómo aparecen los errores y los límites de tasa en las respuestas.
Suscríbete a webhooks para que tus otros sistemas reaccionen cuando algo cambie en FlowEstate.

Empezar

Conceptos centrales

Webhooks

Referencia

1. Crea una API key

2. Prueba la key

3. Crea tu primer lead

4. Siguientes pasos

​1. Crea una API key

​2. Prueba la key

​3. Crea tu primer lead

​4. Siguientes pasos

1. Crea una API key

2. Prueba la key

3. Crea tu primer lead

4. Siguientes pasos