Create a catalog item

Changed on

Save a product or service to reuse on invoices. See Catalog items.

post/v2/invoices/catalog-items

Request

  • Base URL
    https://api.slash.com
  • URL
    https://api.slash.com/v2/invoices/catalog-items
  • Auth
    API key in header X-API-Key

Headers

X-Idempotency-Keystring required

Unique caller-generated key for one create request. Once an authenticated, schema-valid request reaches the operation, the key is permanently consumed for that operation and legal entity whether the operation succeeds or fails. Reusing it in that scope returns 409 and never replays a response, unlike API v1, which replays the original response for a matching key.

Request body

namestring required
descriptionstring

Example request

{
  "unitAmount": {
    "amount": 45000
  }
}

Response

The created catalog item.

idstring required

Catalog item id with the cat_item_ prefix.

namestring required
descriptionstring
status'active' | 'archived' required

archived marks an item you no longer sell. Archived items can still be invoiced and are listed unless you filter by status.

createdAtstring date-time required

Example response

{
  "id": "cat_item_2rj4l7hmrrrcv",
  "name": "Robot arm maintenance"
}

Changes