Status codes HTTP, códigos de error que puedes pattern-matchar, y la forma de cada response de error.
Todo error tiene una forma JSON consistente:
{ "error": { "message": "Explicación legible para humanos, a veces localizada al idioma de la organización.", "code": "CODIGO_PARA_MAQUINA" }}
Cada error.code corresponde a un solo status HTTP, pero un status puede llevar más de un código — 403 es tanto FORBIDDEN como PLAN_LIMIT_REACHED. Haz switch sobre code, no sobre el status, y muestra message al usuario final.
Códigos
HTTP
error.code
Significado
400
BAD_REQUEST
Error genérico del cliente.
400
VALIDATION_ERROR
El cuerpo o query falló validación. El message lista los campos problemáticos.
400
INVALID_STAGE
stageId no es una etapa del pipeline de esta organización.
400
INELIGIBLE
El lead no puede inscribirse o reanudarse en esta secuencia.
400
SEQUENCE_INACTIVE
La secuencia no está running.
400
NOT_PAUSED
Se pidió resume sin una pausa manual.
400
OPTED_OUT
El lead se dio de baja de WhatsApp.
400
ACCOUNT_UNAVAILABLE
La cuenta remitente de WhatsApp no existe o no está conectada.
401
UNAUTHORIZED
Bearer ausente, mal formado, desconocido o expirado.
403
FORBIDDEN
Autenticado pero sin permiso: scope faltante, key inactiva, credencial personal en una ruta cerrada, o regla de negocio violada.
El recurso no existe, pertenece a otra organización, o está fuera de la cartera del caller.
409
STALE_CORRECTION
El correct.expected del enriquecimiento ya no coincide. Vuelve a leer y reintenta.
409
IDENTITY_CONFLICT
El email o teléfono ya pertenecen a otro lead. Esa otra ficha no se revela.
409
FOLLOW_UP_ACTIVE
Hay un seguimiento activo; complétalo o límpialo antes.
409
ALREADY_ENROLLED
El lead ya está en esta secuencia.
409
WITHDRAWN
La participación ya terminó; el member no puede reinscribir.
429
BAD_REQUEST
Límite de tasa excedido. Reintenta tras Retry-After segundos. Ver Límites de tasa.
429
NUMBER_RATE_LIMITED
El número de WhatsApp está pausado o sin presupuesto.
500
INTERNAL_ERROR
Falla inesperada del servidor. Es seguro reintentar de forma idempotente tras un breve backoff.
Errores de límite del plan
Un límite de plan no es un problema de permisos, pero llega en el mismo status code. Hacé match sobre error.code, no sobre el status:
Endpoint
Límite
HTTP
error.code
POST /leads
maxLeads
403
PLAN_LIMIT_REACHED
POST /projects
maxProjects
403
FORBIDDEN
POST /webhooks/subscriptions
maxWebhookEndpoints
403
FORBIDDEN
{ "error": { "message": "Lead limit reached for the organization plan", "code": "PLAN_LIMIT_REACHED" }}
PLAN_LIMIT_REACHED se agregó para que “tu plan está lleno” deje de ser indistinguible de “a tu key le falta el scope” — antes las dos llegaban como un 403 FORBIDDEN pelado. El status code no cambió, así que los clientes que solo chequean 403 siguen funcionando igual. Los otros dos endpoints siguen devolviendo FORBIDDEN y pasarán a tener código propio en una versión posterior.
Los errores de límite de plan llevan un mensaje que puede venir localizado al idioma de la organización, como “Has alcanzado el número máximo de leads de tu plan.” — muéstraselo al usuario final tal cual, ya que son ellos los que pueden actuar (subir plan o eliminar registros).Reintentar un PLAN_LIMIT_REACHED no sirve de nada hasta que la organización mejore el plan: el veredicto no puede cambiar solo. Alertá en vez de reintentar, y guardá el payload si no podés darte el lujo de perderlo.Una fusión nunca se bloquea por el límite de leads: no se crea ningún lead, así que no consume cupo. Una organización en su tope igual puede seguir enriqueciendo los leads que ya tiene.
Errores de validación
Los mensajes VALIDATION_ERROR listan cada campo que falló en formato path: razón, separados por ; :
{ "error": { "message": "Validation error: email: Invalid email; phone: String must be at most 50 characters", "code": "VALIDATION_ERROR" }}
Parsea el mensaje si necesitas mostrar errores a nivel de campo en tu propia UI, o muestra el string completo.
Idempotencia y reintentos
5xx y 429 son seguros para reintentar. Usa exponential backoff topado al valor de Retry-After cuando esté presente.
4xx (excepto 429) significa que el request en sí está mal. No reintentes sin cambiarlo.
POST /webhooks/subscriptions es idempotente cuando pasas external_id — ver Crear una suscripción.
POST /leads es idempotente por identidad de contacto: reintentar con el mismo correo o teléfono fusiona sobre el lead existente en vez de crear un duplicado. Leé outcome en la respuesta para distinguir un alta de una fusión — ver Deduplicación y fusión.
Otras escrituras no son idempotentes. Reintentarlas a ciegas crea registros duplicados.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"FlowEstate Developers","description":"Build integrations on top of FlowEstate. REST API for leads, personal member access, projects, units, and outbound webhooks.","colors":{"primary":"#3066B6","light":"#5D8FD0","dark":"#1F4373"},"logo":{"light":"https://mintcdn.com/flowestate/ksRHPKktoRN6u81O/logo/light.svg?fit=max\u0026auto=format\u0026n=ksRHPKktoRN6u81O\u0026q=85\u0026s=5c2fb629132bfb174396224c285666dc","dark":"https://mintcdn.com/flowestate/ksRHPKktoRN6u81O/logo/dark.svg?fit=max\u0026auto=format\u0026n=ksRHPKktoRN6u81O\u0026q=85\u0026s=d19d5534db3207dd3b86ff78f71974d5","href":"https://developers.flowestate.app"},"favicon":"https://mintcdn.com/flowestate/ksRHPKktoRN6u81O/favicon.svg?fit=max\u0026auto=format\u0026n=ksRHPKktoRN6u81O\u0026q=85\u0026s=21a743943c7ba01b5f69c4040d3184d1","navbar":{"links":[{"href":"https://panel.flowestate.app","label":"Dashboard"}],"primary":{"type":"button","label":"Get API Key","href":"https://panel.flowestate.app/dashboard/settings/api-keys"}},"footer":{"socials":{"x":"https://x.com/flowestate","linkedin":"https://www.linkedin.com/company/flowestate"}},"search":{"prompt":"Search FlowEstate API docs..."},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Status","icon":"signal-bars","href":"https://status.flowestate.app"},{"anchor":"Support","icon":"envelope","href":"mailto:soporte@flowestate.app"}]},"languages":[{"language":"en","href":"introduction"},{"language":"es","href":"es/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"flowestate","hasAudioNarration":false,"actualSubdomain":"flowestate","customDomains":["developers.flowestate.app"],"gitSource":{"type":"github","owner":"flow-estate","repo":"flowestate-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aa64ad4882bb710a9b8f0b4","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"en","tag":"API Reference","count":13},{"language":"es","tag":"Referencia API","count":13},{"language":"en","tag":"Documentation","count":12},{"language":"es","tag":"Documentación","count":12},{"language":"en","tag":"Core concepts","count":7},{"language":"es","tag":"Conceptos centrales","count":7},{"language":"en","tag":"Automation","count":4},{"language":"es","tag":"Automatización","count":4},{"language":"en","tag":"Leads","count":3},{"language":"es","tag":"Leads","count":3},{"language":"en","tag":"Overview","count":2},{"language":"en","tag":"Catalog","count":2},{"language":"en","tag":"Webhooks","count":2},{"language":"en","tag":"Reference","count":2},{"language":"en","tag":"Get Started","count":2},{"language":"es","tag":"Generales","count":2},{"language":"es","tag":"Catálogo","count":2},{"language":"es","tag":"Webhooks","count":2},{"language":"es","tag":"Referencia","count":2},{"language":"es","tag":"Empezar","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"es/errors","slug":"/es/errors","pageMetadata":{"title":"Errores","description":"Status codes HTTP, códigos de error que puedes pattern-matchar, y la forma de cada response de error.","href":"/es/errors"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Status codes HTTP, códigos de error que puedes pattern-matchar, y la forma de cada response de error.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Todo error tiene una forma JSON consistente:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Explicación legible para humanos, a veces localizada al idioma de la organización.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CODIGO_PARA_MAQUINA\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Cada `,_jsx(_components.code,{children:`error.code`}),` corresponde a un solo status HTTP, pero un status puede llevar más de un código — `,_jsx(_components.code,{children:`403`}),` es tanto `,_jsx(_components.code,{children:`FORBIDDEN`}),` como `,_jsx(_components.code,{children:`PLAN_LIMIT_REACHED`}),`. `,_jsxs(_components.strong,{children:[`Haz switch sobre `,_jsx(_components.code,{children:`code`})]}),`, no sobre el status, y muestra `,_jsx(_components.code,{children:`message`}),` al usuario final.`]}),`\n`,_jsx(Heading,{level:`2`,id:`códigos`,children:`Códigos`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`error.code`})}),_jsx(_components.th,{children:`Significado`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`BAD_REQUEST`})}),_jsx(_components.td,{children:`Error genérico del cliente.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VALIDATION_ERROR`})}),_jsxs(_components.td,{children:[`El cuerpo o query falló validación. El `,_jsx(_components.code,{children:`message`}),` lista los campos problemáticos.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_STAGE`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`stageId`}),` no es una etapa del pipeline de esta organización.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INELIGIBLE`})}),_jsx(_components.td,{children:`El lead no puede inscribirse o reanudarse en esta secuencia.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`SEQUENCE_INACTIVE`})}),_jsxs(_components.td,{children:[`La secuencia no está `,_jsx(_components.code,{children:`running`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NOT_PAUSED`})}),_jsx(_components.td,{children:`Se pidió resume sin una pausa manual.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`OPTED_OUT`})}),_jsx(_components.td,{children:`El lead se dio de baja de WhatsApp.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ACCOUNT_UNAVAILABLE`})}),_jsx(_components.td,{children:`La cuenta remitente de WhatsApp no existe o no está conectada.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`UNAUTHORIZED`})}),_jsx(_components.td,{children:`Bearer ausente, mal formado, desconocido o expirado.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`FORBIDDEN`})}),_jsx(_components.td,{children:`Autenticado pero sin permiso: scope faltante, key inactiva, credencial personal en una ruta cerrada, o regla de negocio violada.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`PLAN_LIMIT_REACHED`})}),_jsxs(_components.td,{children:[`El plan de la organización está lleno. Ver `,_jsx(_components.a,{href:`#errores-de-l%C3%ADmite-del-plan`,children:`Errores de límite del plan`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NOT_FOUND`})}),_jsx(_components.td,{children:`El recurso no existe, pertenece a otra organización, o está fuera de la cartera del caller.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`STALE_CORRECTION`})}),_jsxs(_components.td,{children:[`El `,_jsx(_components.code,{children:`correct.expected`}),` del enriquecimiento ya no coincide. Vuelve a leer y reintenta.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`IDENTITY_CONFLICT`})}),_jsx(_components.td,{children:`El email o teléfono ya pertenecen a otro lead. Esa otra ficha no se revela.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`FOLLOW_UP_ACTIVE`})}),_jsx(_components.td,{children:`Hay un seguimiento activo; complétalo o límpialo antes.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ALREADY_ENROLLED`})}),_jsx(_components.td,{children:`El lead ya está en esta secuencia.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`WITHDRAWN`})}),_jsx(_components.td,{children:`La participación ya terminó; el member no puede reinscribir.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`429`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`BAD_REQUEST`})}),_jsxs(_components.td,{children:[`Límite de tasa excedido. Reintenta tras `,_jsx(_components.code,{children:`Retry-After`}),` segundos. Ver `,_jsx(_components.a,{href:`/es/rate-limits`,children:`Límites de tasa`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`429`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NUMBER_RATE_LIMITED`})}),_jsx(_components.td,{children:`El número de WhatsApp está pausado o sin presupuesto.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`500`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INTERNAL_ERROR`})}),_jsx(_components.td,{children:`Falla inesperada del servidor. Es seguro reintentar de forma idempotente tras un breve backoff.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`errores-de-límite-del-plan`,children:`Errores de límite del plan`}),`\n`,_jsxs(_components.p,{children:[`Un límite de plan no es un problema de permisos, pero llega en el mismo status code. Hacé match sobre `,_jsx(_components.code,{children:`error.code`}),`, no sobre el status:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Endpoint`}),_jsx(_components.th,{children:`Límite`}),_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`error.code`})})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /leads`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`maxLeads`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`PLAN_LIMIT_REACHED`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /projects`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`maxProjects`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`FORBIDDEN`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /webhooks/subscriptions`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`maxWebhookEndpoints`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`FORBIDDEN`})})]})]})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Lead limit reached for the organization plan\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PLAN_LIMIT_REACHED\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Note,{children:[_jsx(_components.code,{children:`PLAN_LIMIT_REACHED`}),` se agregó para que “tu plan está lleno” deje de ser indistinguible de “a tu key le falta el scope” — antes las dos llegaban como un `,_jsx(_components.code,{children:`403 FORBIDDEN`}),` pelado. El status code `,_jsx(_components.strong,{children:`no`}),` cambió, así que los clientes que solo chequean `,_jsx(_components.code,{children:`403`}),` siguen funcionando igual. Los otros dos endpoints siguen devolviendo `,_jsx(_components.code,{children:`FORBIDDEN`}),` y pasarán a tener código propio en una versión posterior.`]}),`\n`,_jsxs(_components.p,{children:[`Los errores de límite de plan llevan un mensaje que puede venir localizado al idioma de la organización, como `,_jsx(_components.em,{children:`“Has alcanzado el número máximo de leads de tu plan.”`}),` — muéstraselo al usuario final tal cual, ya que son ellos los que pueden actuar (subir plan o eliminar registros).`]}),`\n`,_jsxs(_components.p,{children:[`Reintentar un `,_jsx(_components.code,{children:`PLAN_LIMIT_REACHED`}),` no sirve de nada hasta que la organización mejore el plan: el veredicto no puede cambiar solo. Alertá en vez de reintentar, y guardá el payload si no podés darte el lujo de perderlo.`]}),`\n`,_jsxs(_components.p,{children:[`Una `,_jsx(_components.strong,{children:`fusión`}),` nunca se bloquea por el límite de leads: no se crea ningún lead, así que no consume cupo. Una organización en su tope igual puede seguir enriqueciendo los leads que ya tiene.`]}),`\n`,_jsx(Heading,{level:`2`,id:`errores-de-validación`,children:`Errores de validación`}),`\n`,_jsxs(_components.p,{children:[`Los mensajes `,_jsx(_components.code,{children:`VALIDATION_ERROR`}),` listan cada campo que falló en formato `,_jsx(_components.code,{children:`path: razón`}),`, separados por `,_jsx(_components.code,{children:`; `}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Validation error: email: Invalid email; phone: String must be at most 50 characters\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"VALIDATION_ERROR\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Parsea el mensaje si necesitas mostrar errores a nivel de campo en tu propia UI, o muestra el string completo.`}),`\n`,_jsx(Heading,{level:`2`,id:`idempotencia-y-reintentos`,children:`Idempotencia y reintentos`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`5xx`}),` y `,_jsx(_components.code,{children:`429`}),` son seguros para reintentar. Usa exponential backoff topado al valor de `,_jsx(_components.code,{children:`Retry-After`}),` cuando esté presente.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`4xx`}),` (excepto `,_jsx(_components.code,{children:`429`}),`) significa que el request en sí está mal. No reintentes sin cambiarlo.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`POST /webhooks/subscriptions`}),` es idempotente cuando pasas `,_jsx(_components.code,{children:`external_id`}),` — ver `,_jsx(_components.a,{href:`/es/api-reference/webhooks#crear-una-suscripci%C3%B3n`,children:`Crear una suscripción`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`POST /leads`}),` es idempotente por identidad de contacto: reintentar con el mismo correo o teléfono fusiona sobre el lead existente en vez de crear un duplicado. Leé `,_jsx(_components.code,{children:`outcome`}),` en la respuesta para distinguir un alta de una fusión — ver `,_jsx(_components.a,{href:`/es/api-reference/leads#deduplicaci%C3%B3n-y-fusi%C3%B3n`,children:`Deduplicación y fusión`}),`.`]}),`\n`,_jsx(_components.li,{children:`Otras escrituras no son idempotentes. Reintentarlas a ciegas crea registros duplicados.`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Errores","description":"Status codes HTTP, códigos de error que puedes pattern-matchar, y la forma de cada response de error.","href":"/es/errors"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Códigos","slug":"códigos","depth":2,"children":[]},{"title":"Errores de límite del plan","slug":"errores-de-límite-del-plan","depth":2,"children":[]},{"title":"Errores de validación","slug":"errores-de-validación","depth":2,"children":[]},{"title":"Idempotencia y reintentos","slug":"idempotencia-y-reintentos","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"flowestate","siteName":"FlowEstate Developers","title":"Errores - FlowEstate Developers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/errors","matchLevel":1},"es":{"href":"/es/errors","matchLevel":0}}},"lastModified":"2026-09-13T07:04:07.000Z","originalFileLocation":"es/errors.mdx","locale":"es"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Status codes HTTP, códigos de error que puedes pattern-matchar, y la forma de cada response de error.\">\u003cmeta data-mint-head name=\"application-name\" content=\"FlowEstate Developers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/flowestate/MgICMXQhbd1W6J6T/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/flowestate/MgICMXQhbd1W6J6T/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/flowestate/MgICMXQhbd1W6J6T/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/flowestate/MgICMXQhbd1W6J6T/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/flowestate/MgICMXQhbd1W6J6T/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/flowestate/MgICMXQhbd1W6J6T/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/flowestate/MgICMXQhbd1W6J6T/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/flowestate/MgICMXQhbd1W6J6T/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/flowestate/MgICMXQhbd1W6J6T/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Errores - FlowEstate Developers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Status codes HTTP, códigos de error que puedes pattern-matchar, y la forma de cada response de error.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"FlowEstate Developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.flowestate.app/es/errors\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://flowestate.mintlify.site/_mintlify/api/og/v2?division=Conceptos+centrales\u0026amp;title=Errores\u0026amp;description=Status+codes+HTTP%2C+c%C3%B3digos+de+error+que+puedes+pattern-matchar%2C+y+la+forma+de+cada+response+de+error.\u0026amp;theme=3c20f3b766a9e483e07b7cd4\u0026amp;signature=be27f11b70185200a138988125679b8c94cb57ebfb838cdeab2f1c120afc1827\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Errores - FlowEstate Developers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Status codes HTTP, códigos de error que puedes pattern-matchar, y la forma de cada response de error.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://flowestate.mintlify.site/_mintlify/api/og/v2?division=Conceptos+centrales\u0026amp;title=Errores\u0026amp;description=Status+codes+HTTP%2C+c%C3%B3digos+de+error+que+puedes+pattern-matchar%2C+y+la+forma+de+cada+response+de+error.\u0026amp;theme=3c20f3b766a9e483e07b7cd4\u0026amp;signature=be27f11b70185200a138988125679b8c94cb57ebfb838cdeab2f1c120afc1827\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/flowestate/MgICMXQhbd1W6J6T/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"FlowEstate Developers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3066B6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.flowestate.app/es/errors\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/es/errors.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://developers.flowestate.app/es/errors\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://developers.flowestate.app/errors\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://developers.flowestate.app/errors\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.flowestate.app/#organization\",\"name\":\"FlowEstate Developers\",\"url\":\"https://developers.flowestate.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/flowestate/ksRHPKktoRN6u81O/logo/light.svg?fit=max\u0026auto=format\u0026n=ksRHPKktoRN6u81O\u0026q=85\u0026s=5c2fb629132bfb174396224c285666dc\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.flowestate.app#website\",\"name\":\"FlowEstate Developers\",\"url\":\"https://developers.flowestate.app\",\"publisher\":{\"@id\":\"https://developers.flowestate.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.flowestate.app/es/errors#webpage\",\"url\":\"https://developers.flowestate.app/es/errors\",\"name\":\"Errores\",\"description\":\"Status codes HTTP, códigos de error que puedes pattern-matchar, y la forma de cada response de error.\",\"dateModified\":\"2026-09-13T07:04:07.000Z\",\"isPartOf\":{\"@id\":\"https://developers.flowestate.app#website\"},\"breadcrumb\":{\"@id\":\"https://developers.flowestate.app/es/errors#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.flowestate.app/es/errors#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Conceptos centrales\",\"item\":\"https://developers.flowestate.app/es/authentication\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Errores\",\"item\":\"https://developers.flowestate.app/es/errors\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developers.flowestate.app/es/errors#article\",\"headline\":\"Errores\",\"name\":\"Errores\",\"description\":\"Status codes HTTP, códigos de error que puedes pattern-matchar, y la forma de cada response de error.\",\"url\":\"https://developers.flowestate.app/es/errors\",\"mainEntityOfPage\":{\"@id\":\"https://developers.flowestate.app/es/errors#webpage\"},\"dateModified\":\"2026-09-13T07:04:07.000Z\",\"publisher\":{\"@id\":\"https://developers.flowestate.app/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.flowestate.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"FlowEstate Developers\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"FlowEstate Developers\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/es/errors.md","siteName":"FlowEstate Developers","nav":{"global":{"anchors":[{"anchor":"Status","icon":"signal-bars","href":"https://status.flowestate.app"},{"anchor":"Support","icon":"envelope","href":"mailto:soporte@flowestate.app"}]},"languages":[{"language":"en","pages":[{"title":"en","href":"/errors"}]},{"language":"es","tabs":[{"tab":"Documentación","groups":[{"group":"Empezar","pages":[{"title":"API de FlowEstate","href":"/es/introduction"},{"title":"Inicio rápido","href":"/es/quickstart"}]},{"group":"Conceptos centrales","pages":[{"title":"Autenticación","href":"/es/authentication"},{"title":"Acceso API personal","href":"/es/member-access"},{"title":"Scopes","href":"/es/scopes"},{"title":"Límites de tasa","href":"/es/rate-limits"},{"title":"Formato de respuesta","href":"/es/response-format"},{"title":"Paginación","description":"Parámetros de query estándar para endpoints de lista, y cómo recorrer cada página.","href":"/es/pagination"},{"title":"Errores","href":"/es/errors"}]},{"group":"Webhooks","pages":[{"title":"Recibir webhooks","description":"Notificaciones HTTP POST salientes cuando algo cambia en FlowEstate. Headers, verificación de firma, política de reintentos, prevención de bucles.","href":"/es/webhooks"}]},{"group":"Referencia","pages":[{"title":"Referencia de enums","href":"/es/enums"},{"title":"Solución de problemas","href":"/es/troubleshooting"}]}]},{"tab":"Referencia API","pages":[{"title":"Referencia API","href":"/es/api-reference/overview"}]}]}]},"basePath":"","title":"Errores - FlowEstate Developers","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}