Saltar al contenido principal

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.

1. Crea una API key

  1. Inicia sesión en tu organización de FlowEstate en 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_.
    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"
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"
  }'
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