---
title: "Creates a new keyword"
method: POST
path: "/dashboards/{dashboard_id}/keywords"
tags: ["Keywords"]
---

# Creates a new keyword

`POST /dashboards/{dashboard_id}/keywords`

Creates a new keyword with the provided name.

## Path parameters

- `dashboard_id` integer, required

## Request body

- PostKeywordRequest
  - `keyword_value` string, required — Name of the keyword group.
  - `response` string — Any notes on this keyword group.

## Response `200`

The new group.

- Keyword
  - `id` integer — The keyword identifier.
  - `subscribers_count` integer — Number of members of the keyword.
  - `keyword_value` string — Name of the keyword.
  - `date_created` string, date-time — When the keyword was created.
  - `response` string — The response for the keyword.
  - `group_id` integer — The group associated with this keyword. Use it to retrieve members of the keyword.

## Other responses

- `400` — Bad request - no name was specified.
- `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)