# Create New Item

`POST /api/items`



- **Group:** Items
- **Since:** v0.1.0
- **Authentication:** `authtoken` header, created under Setup > API > API Management
- **HTML version:** /apiguide/items/post-item/

## Headers

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

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `description` | String | **required** | Mandatory item description/name |
| `rate` | Number | **required** | Mandatory item rate/price |
| `long_description` | String | optional | Optional long description |
| `tax` | Number | optional | Optional primary tax ID |
| `tax2` | Number | optional | Optional secondary tax ID |
| `group_id` | Number | optional | Optional item group ID (default: 0) |
| `unit` | String | optional | Optional unit of measurement |

## Example request

```bash
curl -X POST "https://yoursite.com/api/items" \
  -H "authtoken: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "description": "...", "rate": "..." }'
```

## Success response

### Success-Response:

```json
HTTP/1.1 200 OK
{
  "status": true,
  "message": "Item created successfully",
  "item_id": 123
}
```

## Error responses

### Error-Response:

```json
HTTP/1.1 404 Not Found
{
  "status": false,
  "message": "Item creation failed"
}
```

---

Perfex CRM REST API by Themesic Interactive. Full reference: /apiguide/