---
title: "POST /api/ee/metabot-tools/create-dashboard-subscription"
method: POST
path: "/api/ee/metabot-tools/create-dashboard-subscription"
tags: ["/api/ee/metabot-tools"]
---

# POST /api/ee/metabot-tools/create-dashboard-subscription

`POST /api/ee/metabot-tools/create-dashboard-subscription`

Create a dashboard subscription.

## Request body

- object — Base schema for all tool requests. Contains the conversation ID and optional profile ID.
  - `arguments` MetabaseEnterpriseMetabotV3ToolsApiCreateDashboardSubscriptionArguments, required
    - `dashboard_id` integer, required
    - `email` string, required
    - `schedule` union, required
      - object
        - `frequency` 'hourly', required
      - object
        - `frequency` 'daily', required
        - `hour` integer, required
      - object
        - `day_of_week` 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday', required
        - `frequency` 'weekly', required
        - `hour` integer, required
      - object
        - `day_of_month` 'first-calendar-day' | 'middle-of-month' | 'last-calendar-day' | 'first-sunday' | 'first-monday' | 'first-tuesday' | 'first-wednesday' | 'first-thursday' | 'first-friday' | 'first-saturday' | 'last-sunday' | 'last-monday' | 'last-tuesday' | 'last-wednesday' | 'last-thursday' | 'last-friday' | 'last-saturday', required
        - `frequency` 'monthly', required
        - `hour` integer, required
  - `conversation_id` string, required — value must be a valid UUID.
  - `profile_id` string, nullable

## Response `2XX`

Base schema for all tool requests. Contains the conversation ID and optional profile ID.

- object — Base schema for all tool requests. Contains the conversation ID and optional profile ID.
  - `conversation_id` string, required — value must be a valid UUID.
  - `output` string, required
  - `profile_id` string, nullable

## Other responses

- `4XX` — Client error response
- `5XX` — Server error response

## Changes

- **2026-01-20** `bd1deee7eae2` — 2 info
  - added the new optional request property `profile_id`
  - added the optional property `profile_id` to the response with the `2XX` status

[Change history](https://skmtc.dev/metabase/apis/metabase-api/changes/api/ee/metabot-tools/create-dashboard-subscription/post.md)

---

[API](https://skmtc.dev/metabase/apis/metabase-api.md) · [All operations](https://skmtc.dev/metabase/apis/metabase-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/metabase/metabase-api/revisions/bd1deee7eae2/schema)