---
title: "Create a new predefined item"
description: "POST /predefined_items — Creates a predefined item. name is required and must be unique on the account; description, cost and price are optional. Requires the deal items permission."
canonical_url: https://developer.onepagecrm.com/api/reference/predefined-items/post-predefined_items/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/predefined-items/post-predefined_items/
---

`POST /predefined_items`

Creates a predefined item. name is required and must be unique on the account; description, cost and price are optional. Requires the deal items permission. Accounts are capped at 1000 predefined items.

Resource: [Predefined Items](https://developer.onepagecrm.com/api/reference/predefined-items/) · [API Reference](https://developer.onepagecrm.com/api/reference/)

## Request

```bash
curl -X POST "https://app.onepagecrm.com/api/v3/predefined_items" \
  -u $user_id:$api_key \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Solar panels",
    "description": "Photovoltaic solar panels (2019 model)",
    "cost": 95,
    "price": 149.99
  }'
```

Authentication is HTTP Basic — `user_id` as username, `api_key` as password.
See https://developer.onepagecrm.com/api/authentication/.

## Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string |  | Name of the predefined item |
| `description` | string |  | Description text of the predefined item |
| `cost` | number (float) |  | Cost of the predefined item (if deals costs are enabled) |
| `price` | number (float) |  | Price of the predefined item |

## Responses

### 201

Created

```json
{
  "status": 0,
  "message": "OK",
  "timestamp": 1528373119,
  "data": {
    "predefined_item": {
      "id": "5c79510e9007ba3f7519e819",
      "name": "Solar panels",
      "description": "Photovoltaic solar panels (2019 model)",
      "cost": 95,
      "price": 149.99,
      "position": 1,
      "item_group_id": "5c9a53599007ba58f13c8119"
    }
  }
}
```

Standard error responses: 400, 401, 403, 404, 409, 500 — shared across the API. See https://developer.onepagecrm.com/api/errors/.

## Related guides

- [Authentication](https://developer.onepagecrm.com/api/authentication/)
- [Errors](https://developer.onepagecrm.com/api/errors/)
- [Rate limits](https://developer.onepagecrm.com/api/rate-limits/)