# POST /api/knowledge-base/articles

> Knowledge Base - Add New Article

- **Endpoint:** `POST /api/knowledge-base/articles`
- **Group:** Knowledge Base
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/KnowledgeBaseController.php`

## Headers

| Field | Type | Description |
| --- | --- | --- |
| `authtoken` | String | Authentication token, generated from admin area |

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | String | yes | Mandatory Article title |
| `category_id` | Number | yes | Mandatory Help category ID, must exist |
| `description` | String | no | Optional Article body |
| `status` | String | no | Optional active or inactive, defaults to active |
| `sort` | Number | no | Optional sort order, defaults to 0 |
| `labels` | String | no | Optional comma separated label IDs |
| `related_article_ids` | String | no | Optional comma separated article IDs |
| `created_by` | Number | no | Optional user ID to attribute the record to |

## Request example

```bash
curl -X POST "https://yoursite.com/index.php/api/knowledge-base/articles" \
  -H "authtoken: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "title": "...", "category_id": "..." }'
```

## Responses

### Success - Success-Response:

```json
HTTP/1.1 201 Created
{ "status": 200, "messages": {"success": "The record has been saved."}, "id": 12 }
```

---

Part of the [REST API for RISE CRM](https://risecrm.themesic.com/apiguide/) documentation.
Full page: https://risecrm.themesic.com/apiguide/knowledge-base/create-knowledge-base-article/