# POST /api/leave-applications

> Leave Applications - Add Leave Application

- **Endpoint:** `POST /api/leave-applications`
- **Group:** Leave Applications
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/LeaveApplicationsController.php`

## Headers

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

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `leave_type_id` | number | yes | Mandatory Leave type ID |
| `applicant_id` | number | yes | Mandatory Applicant user ID |
| `start_date` | string | yes | Mandatory Start date (Y-m-d) |
| `end_date` | string | yes | Mandatory End date (Y-m-d) |
| `reason` | string | yes | Mandatory Leave reason |
| `total_days` | number | no | Optional Total days (auto-calculated if not provided) |

## Request example

```bash
curl -X POST "https://yoursite.com/index.php/api/leave-applications" \
  -H "authtoken: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "leave_type_id": "...", "applicant_id": "...", "start_date": "...", "end_date": "...", "reason": "..." }'
```

## Responses

### Success - Success-Response:

```json
HTTP/1.1 201 Created
{
  "status": 200,
  "messages": {"success": "Leave application add success"},
  "id": 1
}
```

---

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