You are viewing an old version of the API
Create category
V1

Deprecated

Note We recommend using the Square API (V2) for all new development when possible.

Creates an item category



Required permissions ITEMS_WRITE

Path Parameters

Name Description
location_id
string

Required

The ID of the location to create an item for.

Request Body

Name Description
id
string

The category's unique ID.

name
string

The category's name.

v2_id
string

The ID of the CatalogObject in the Connect v2 API. Objects that are shared across multiple locations share the same v2 ID.

Response Fields

Name Description
id
string

The category's unique ID.

name
string

The category's name.

v2_id
string

The ID of the CatalogObject in the Connect v2 API. Objects that are shared across multiple locations share the same v2 ID.

Examples

You are viewing an old version of the API
POST /v1/{location_id}/categories
cURL
  • cURL
curl https://connect.squareup.com/v1/{location_id}/categories \
  -X POST \
  -H 'Authorization: Bearer ACCESS_TOKEN'

Share Feedback

Thanks for visiting the Square API documentation. What's on your mind?