Create an item

POST /v1/items

Bearer token

curl 'https://api.sendapropos.com/v1/items' \
  --request POST \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "example",
  "description": "example",
  "default_price": 1,
  "item_type": "service",
  "external_system": "example",
  "external_id": "external_01JXY9AZK4KV"
}'

{
  "data": {
    "id": "123e4567-e89b-42d3-a456-426614174000",
    "name": "example",
    "description": "example",
    "defaultPrice": 1,
    "itemType": "service",
    "status": "active",
    "createdAt": "2026-01-01T12:00:00Z"
  }
}

Item created.

Body

· CreateItemRequest

required application/json

name string · max length: 200 required

description string · max length: 2000

default_price number · min: 0· max: 999999.99 required

item_type ItemType · enum

values

service
non_inventory
inventory
group

external_system string · max length: 100

Provide together with external_id to record a mapping for future find-before-create lookups.

external_id string · max length: 200

Body

Responses