# Crear grupo de conexiones
> Crea un grupo vacío.
{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}
| | |
| ------------------- | ------------------------------------------------------------------- |
| **Tool ID** | `conexiones.grupos.crear` |
| **Nombre MCP** | `conexiones__grupos__crear` |
| **Conector** | `conexiones` |
| **Plano** | `action` |
| **Scope (permiso)** | `conexiones:grupos:write` |
| **Auth** | `none` |
| **Versión** | `1` |
| **Sensible** | no |
| **Deprecado** | no |
| **Comportamiento** | readOnly=false, destructive=false, idempotent=true, openWorld=false |
## Qué hace [#qué-hace]
Queda al final del menú de conexiones de la organización. El nombre es único sin distinguir mayúsculas: si ya existe un grupo con el mismo nombre, icono y color, lo devuelve sin crear otro; si existe con otro icono o color, falla. Exige una credencial con acceso a todas las conexiones. Para llenarlo usa conexiones.grupos.mover.
## Entrada [#entrada]
| Campo | Tipo | Requerido | Descripción |
| -------- | ------------------------------------------------------------------------------------------------- | ------------------------ | ------------------------------------------- |
| `nombre` | string | sí | El nombre del grupo, hasta 40 caracteres. |
| `icono` | `"folder"` · `"wallet"` · `"building-2"` · `"users"` · `"megaphone"` · `"briefcase-business"` · … | no · default `"folder"` | El icono del grupo, de un catálogo cerrado. |
| `color` | `"neutral"` · `"red"` · `"orange"` · `"yellow"` · `"green"` · `"blue"` · … | no · default `"neutral"` | El color del grupo, de un catálogo cerrado. |
JSON Schema de entrada
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "El nombre del grupo, hasta 40 caracteres."
},
"icono": {
"default": "folder",
"type": "string",
"enum": [
"folder",
"wallet",
"building-2",
"users",
"megaphone",
"briefcase-business",
"landmark",
"receipt",
"chart-no-axes-combined",
"shopping-bag",
"store",
"package",
"globe",
"code-xml",
"database",
"cloud",
"calendar-days",
"messages-square",
"heart-handshake",
"rocket",
"lightbulb",
"star",
"shield-check",
"layers"
],
"description": "El icono del grupo, de un catálogo cerrado."
},
"color": {
"default": "neutral",
"type": "string",
"enum": [
"neutral",
"red",
"orange",
"yellow",
"green",
"blue",
"violet",
"pink"
],
"description": "El color del grupo, de un catálogo cerrado."
}
},
"required": [
"nombre"
]
}
```
## Ejemplo [#ejemplo]
```bash title="curl"
curl -X POST https://connect.emisso.ai/api/v1/tools/conexiones.grupos.crear/execute \
-H "Authorization: Bearer connect_sk_…" \
-H "Content-Type: application/json" \
-d '{"input":{"nombre":"Finanzas","icono":"wallet","color":"blue"}}'
```
```json title="MCP · meta-tool execute_write"
{
"tool": "conexiones.grupos.crear",
"params": {
"nombre": "Finanzas",
"icono": "wallet",
"color": "blue"
}
}
```
**Salida esperada (200):**
```json
{
"data": {
"grupo": {
"id": "cgrp_9f2c1a7d",
"nombre": "Finanzas",
"icono": "wallet",
"color": "blue",
"conexionIds": []
},
"creado": true,
"revision": 5
},
"meta": {
"request_id": "req_…",
"tool_id": "conexiones.grupos.crear",
"plane": "action",
"latency_ms": 24,
"audit_status": "recorded"
}
}
```
## Salida [#salida]
| Campo | Tipo | Requerido | Descripción |
| ------------------- | ------------------------------------------------------------------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------- |
| `grupo` | objeto | sí | El grupo creado, o el que ya existía con ese nombre, icono y color. |
| `grupo.id` | string | sí | El id del grupo (cgrp\_…). Es lo que va en 'grupoId' de conexiones.grupos.mover. |
| `grupo.nombre` | string | sí | El nombre del grupo, único dentro de la organización sin distinguir mayúsculas. |
| `grupo.icono` | `"folder"` · `"wallet"` · `"building-2"` · `"users"` · `"megaphone"` · `"briefcase-business"` · … | sí | El icono del grupo, de un catálogo cerrado. |
| `grupo.color` | `"neutral"` · `"red"` · `"orange"` · `"yellow"` · `"green"` · `"blue"` · … | sí | El color del grupo, de un catálogo cerrado. |
| `grupo.conexionIds` | lista de string | sí | Las conexiones (conn\_…) del grupo, en el orden del panel. Solo trae las que esta credencial alcanza. |
| `creado` | booleano | sí | true si esta llamada creó el grupo; false si ya existía uno con ese nombre, icono y color y se devolvió el mismo. |
| `revision` | entero | sí | La revisión de la estructura después de la llamada. |
JSON Schema de salida
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"grupo": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "El id del grupo (cgrp_…). Es lo que va en 'grupoId' de conexiones.grupos.mover."
},
"nombre": {
"type": "string",
"description": "El nombre del grupo, único dentro de la organización sin distinguir mayúsculas."
},
"icono": {
"type": "string",
"enum": [
"folder",
"wallet",
"building-2",
"users",
"megaphone",
"briefcase-business",
"landmark",
"receipt",
"chart-no-axes-combined",
"shopping-bag",
"store",
"package",
"globe",
"code-xml",
"database",
"cloud",
"calendar-days",
"messages-square",
"heart-handshake",
"rocket",
"lightbulb",
"star",
"shield-check",
"layers"
],
"description": "El icono del grupo, de un catálogo cerrado."
},
"color": {
"type": "string",
"enum": [
"neutral",
"red",
"orange",
"yellow",
"green",
"blue",
"violet",
"pink"
],
"description": "El color del grupo, de un catálogo cerrado."
},
"conexionIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Las conexiones (conn_…) del grupo, en el orden del panel. Solo trae las que esta credencial alcanza."
}
},
"required": [
"id",
"nombre",
"icono",
"color",
"conexionIds"
],
"additionalProperties": false,
"description": "El grupo creado, o el que ya existía con ese nombre, icono y color."
},
"creado": {
"type": "boolean",
"description": "true si esta llamada creó el grupo; false si ya existía uno con ese nombre, icono y color y se devolvió el mismo."
},
"revision": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "La revisión de la estructura después de la llamada."
}
},
"required": [
"grupo",
"creado",
"revision"
],
"additionalProperties": false
}
```
## Errores de esta tool [#errores-de-esta-tool]
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).
---
Esta página es parte de la documentación de Emisso Connect. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/referencia/conexiones/grupos-crear.