# POST /api/subscriptions

> Subscriptions - Add New Subscription

- **Endpoint:** `POST /api/subscriptions`
- **Group:** Subscriptions
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/SubscriptionsController.php`

## Headers

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

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `subscription_client_id` | Number | yes | Mandatory Client ID |
| `repeat_type` | String | yes | Mandatory Repeat type (days, weeks, months, years) |
| `title` | String | no | Optional Subscription title |
| `type` | String | no | Optional Subscription type |
| `subscription_bill_date` | String | no | Optional Bill date |
| `tax_id` | Number | no | Optional Tax ID |
| `tax_id2` | Number | no | Optional Second Tax ID |
| `company_id` | Number | no | Optional Company ID |
| `repeat_every` | Number | no | Optional Repeat every (default 1) |
| `subscription_note` | String | no | Optional Note |
| `labels` | String | no | Optional Labels |

## Request example

```bash
curl -X POST "https://yoursite.com/index.php/api/subscriptions" \
  -H "authtoken: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "subscription_client_id": "...", "repeat_type": "..." }'
```

## Responses

### Success - Success-Response:

```json
HTTP/1.1 201 Created
{ "status": 200, "messages": {"success": "Record saved"}, "id": 1 }
```

---

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