# POST /api/tickets

> Tickets - Add New Ticket

- **Endpoint:** `POST /api/tickets`
- **Group:** Tickets
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/TicketsController.php`

## Headers

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

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | yes | Mandatory Ticket title |
| `client_id` | int | yes | Mandatory Ticket client_id |
| `requested_by_id` | int | yes | Mandatory Ticket requested_by_id |
| `ticket_type_id` | int | yes | Mandatory Ticket ticket_type_id |
| `description` | string | yes | Mandatory Ticket description |
| `assigned_to` | int | yes | Mandatory Ticket assigned_to |
| `ticket_labels` | string | yes | Optional Ticket ticket_labels |

## Request example

```bash
curl -X POST "https://yoursite.com/index.php/api/tickets" \
  -H "authtoken: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "title": "...", "client_id": "...", "requested_by_id": "...", "ticket_type_id": "...", "description": "...", "assigned_to": "...", "ticket_labels": "..." }'
```

## Responses

### Success - Success-Response:

```json
HTTP/1.1 200 OK
{
  "status": true,
  "message": "Ticket add successful."
}


HTTP/1.1 404 Not Found
{
  "status": false,
  "message": "Ticket add fail."
}
```

---

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