---
name: metabase_create_dashboard
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "def metabase_create_dashboard(client: MetabaseClient, name: str, description: str = '', collection_id: int = 0) -> dict"
description: "Crea dashboard vacio en Metabase. Para agregar cards usar metabase_update_dashboard con dashcards. Endpoint: POST /api/dashboard."
tags: [metabase, dashboard, create, api, python]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: [httpx]
params:
  - name: client
    desc: "instancia autenticada de MetabaseClient"
  - name: name
    desc: "nombre del dashboard"
  - name: description
    desc: "descripción opcional del dashboard"
  - name: collection_id
    desc: "ID de colección donde guardar el dashboard (0=root)"
output: "dict: objeto dashboard vacío con id asignado"
tested: false
tests: []
test_file_path: ""
file_path: "python/functions/metabase/dashboards.py"
---

## Ejemplo

```python
dash = metabase_create_dashboard(client, "Sales Overview", "KPIs")
# Agregar cards con metabase_update_dashboard
```

## Notas

Se crea vacio. Agregar cards con metabase_update_dashboard(dashcards=[...]).