# Create a new Calendar Event

`POST /api/calendar/`



- **Group:** Calendar Events
- **Since:** v0.0.0
- **Authentication:** `authtoken` header, created under Setup > API > API Management
- **HTML version:** /apiguide/calendar-events/post-calendar-event/

## Headers

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

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | String | **required** | Required event title. |
| `description` | String | **required** | Optional event description. |
| `start` | Date | **required** | Required event start date. |
| `reminder_before_type` | String | **required** | Required value of reminder before type. |
| `reminder_before` | Number | **required** | Required value of reminder before. |
| `color` | String | **required** | Optional event color. |
| `userid` | Number | **required** | Required user id. |
| `isstartnotified` | Number | **required** | Required isstartnotified status. |
| `public` | Number | **required** | Required public status. |

## Example request

```bash
curl -X POST "https://yoursite.com/api/calendar/" \
  -H "authtoken: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "title": "...", "description": "...", "start": "...", "reminder_before_type": "...", "reminder_before": "...", "color": "...", "userid": "...", "isstartnotified": "...", "public": "..." }'
```

## Success response

### Success-Response:

```json
HTTP/1.1 200 OK
 {
     "status": true,
     "message": "Data Added Successfully"
 }
```

## Error responses

### Error-Response:

```json
   HTTP/1.1 404 Not Found
{
    "status": false,
    "message": "Data Creation Failed"
}
```

---

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