# Create an FAQ entry

`POST https://api.cademi.com.br/api/v3/support/faqs`

Operation ID: `faqs.create` · API v3

Creates an FAQ entry with a question and its answer.

Entries are created as drafts unless `status` is set to `published`. Creating a published entry also requires the `faqs.publish` permission.

Groups are labels: a group exists as soon as an entry is assigned to it, so there is no separate operation to create one.

Required permissions: `faqs.create`, `faqs.publish`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `Idempotency-Key` | header | string | yes |  |

## Request body

Content type: `application/json`, required.

| Field | Type | Required | Description |
|---|---|---|---|
| `answer` | object | yes |  |
| `group` | string or null | no |  |
| `question` | string | yes |  |
| `status` | string, one of `draft`, `published` | no |  |

## Responses

### 201

Returns the newly created FAQ entry.

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 422

The request body or query parameters failed validation.

Body: ValidationFailed.

Full schema: https://cademi.dev/openapi/v3.json