---
title: "Create a new dashboard with the given name and phone number"
method: POST
path: "/dashboards"
tags: ["Dashboard"]
---

# Create a new dashboard with the given name and phone number

`POST /dashboards`

Creates a new dashboard in the account. Once the dashboard is created, admins will be emailed about the changed, and can begin assigning users. This endpoint can make a dashboard for any provisioned numbers. You can search for provisioned numbers in a specific area code using GET /dashboards/provisioning. If the phone number is already in use, a Bad Request exception will be thrown.

## Request body

- PostDashboardRequest
  - `name` string — Name of the dashboard.
  - `phone` string — Texting number associated with this dashboard.
  - `timeZoneId` string — The Time Zone of this dashboard. Used in Autoresponders and handling scheduling around time changes

## Response `200`

The new dashboard.

- Dashboard
  - `id` integer — The dashboard identifier. This will be used with all API calls at dashboard level.
  - `name` string — Name of the dashboard.
  - `phone` string — Texting number associated with this dashboard.
  - `timeZoneId` string — The Time Zone of this dashboard. Used in Autoresponders and handling scheduling around time changes

## Other responses

- `400` — Bad request. Sent if required properties are omitted or invalid.
- `401` — Unauthorized. Sent if the API key is omitted or invalid.

---

[API](https://skmtc.net/textrequest/apis/text-request-api-v3.md) · [All operations](https://skmtc.net/textrequest/apis/text-request-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/textrequest/text-request-api-v3/revisions/e4e42efcd650/schema)