# Verificar la cuenta de Instagram
> Comprueba la identidad de la cuenta o página de Instagram autorizada en esta conexión y sus permisos efectivos.
{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}
| | |
| ------------------- | ----------------------------------------------------------------- |
| **Tool ID** | `instagram.conexion.verificar` |
| **Nombre MCP** | `instagram__conexion__verificar` |
| **Conector** | `instagram` |
| **Plano** | `action` |
| **Scope (permiso)** | `instagram:identity` |
| **Auth** | `connection_credentials` |
| **Versión** | `1` |
| **Sensible** | sí |
| **Deprecado** | no |
| **Comportamiento** | readOnly=true, destructive=false, idempotent=true, openWorld=true |
> **Requiere conexión.** Indica cuál en cada llamada: header `X-Connect-Connection` en REST y campo `connectionId` en el `execute` de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de [`conexiones.estado.consultar`](/docs/referencia/conexiones/estado-consultar).
## Qué hace [#qué-hace]
Beta privada: no confirma publicaciones ni formatos.
## Entrada [#entrada]
Sin parámetros: envía `{}`.
JSON Schema de entrada
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {},
"additionalProperties": false
}
```
## Ejemplo [#ejemplo]
```bash title="curl"
curl -X POST https://connect.emisso.ai/api/v1/tools/instagram.conexion.verificar/execute \
-H "Authorization: Bearer connect_sk_…" \
-H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
-H "Content-Type: application/json" \
-d '{"input":{}}'
```
```json title="MCP · meta-tool execute"
{
"tool": "instagram.conexion.verificar",
"params": {},
"connectionId": "conn_9tKfR2mQx4Vb"
}
```
**Salida esperada (200):**
```json
{
"data": {
"verificada": true,
"cuentaId": "123456789",
"permisos": [
"instagram:identity",
"instagram:publish"
]
},
"meta": {
"request_id": "req_…",
"tool_id": "instagram.conexion.verificar",
"plane": "action",
"latency_ms": 7410,
"audit_status": "recorded"
}
}
```
## Salida [#salida]
| Campo | Tipo | Requerido | Descripción |
| ------------ | --------------- | --------- | ----------------------------------------------------------------------------------------------------- |
| `verificada` | booleano | sí | Se verificó la identidad vigente de esta conexión; no acredita una publicación ni todos los formatos. |
| `cuentaId` | string | sí | Cuenta o página autorizada de forma inmutable en esta conexión. |
| `permisos` | lista de string | sí | Permisos de Connect efectivos para esta cuenta, derivados de lo que el proveedor concedió. |
JSON Schema de salida
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"verificada": {
"type": "boolean",
"const": true,
"description": "Se verificó la identidad vigente de esta conexión; no acredita una publicación ni todos los formatos."
},
"cuentaId": {
"type": "string",
"maxLength": 240,
"description": "Cuenta o página autorizada de forma inmutable en esta conexión."
},
"permisos": {
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"description": "Permisos de Connect efectivos para esta cuenta, derivados de lo que el proveedor concedió."
}
},
"required": [
"verificada",
"cuentaId",
"permisos"
],
"additionalProperties": false
}
```
## Errores de esta tool [#errores-de-esta-tool]
| Código | HTTP | Reintentable | Qué hacer |
| -------------------------------- | ---- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `connection_disabled` | 403 | no | Reactívala en /connections o usa otra conexión del mismo sistema. |
| `connection_not_found` | 404 | no | Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada. |
| `connection_credential_required` | 428 | no | Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior. |
| `connection_busy` | 409 | sí | Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez. |
| `upstream_error` | 502 | sí | Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración. |
| `timeout` | 504 | sí | Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo. |
| `connector_onboarding_required` | 428 | no | Lee el mensaje: dice qué falta. Se completa en el portal de ese sistema, no en Connect, y después la llamada funciona sin cambios. |
| `connection_scope_not_enabled` | 403 | no | Pide a un owner/admin que habilite el scope en /connections para esa conexión, o usa otra que ya lo tenga activo. Cambiar la credencial del actor no resuelve este error. |
| `rate_limited` | 429 | sí | Espera y reintenta con backoff exponencial. |
| `upstream_unexpected_response` | 502 | no | No reintentes: la respuesta es determinista. Repórtalo con el request\_id para que actualicemos el conector. |
| `external_resource_not_found` | 404 | no | Verifica el identificador con la tool de búsqueda del mismo sistema. Reintentar con el mismo identificador da el mismo resultado. |
Toda llamada puede devolver además los códigos transversales (`validation_error`, `unauthorized`, `scope_not_granted`, `rate_limited`, entre otros): el detalle vive en el [catálogo de errores](/docs/referencia/errores).
## Próximos pasos [#próximos-pasos]
* [`instagram.conexion.sincronizar`](/docs/referencia/instagram/conexion-sincronizar): si la credencial verifica bien, el paso siguiente es traer datos.