Products

Overview

Products represent the items or services you offer to customers. Each product can have multiple plans with different pricing options. Products include settings for visibility, shipping requirements, and geographic availability.

API Endpoints

MethodEndpointDescription
GET/productsList products
POST/productsCreate product
GET/products/{id}Get product
PUT/products/{id}Update product
DELETE/products/{id}Delete product

Product Object

AttributeTypeDescription
idintegerUnique identifier for the product
activebooleanWhether the product is active (automatically set to true on creation)
address_requiredintegerWhether a shipping address is required (0 or 1)
descriptionstringCustomer-facing product description
entitlementsobjectAccess permissions granted by this product
is_hiddenbooleanWhether the product is hidden from public display
is_importedbooleanWhether the product was imported from an external system
languagestringProduct language locale (e.g. en_US, fr_CA)
namestringPublic product name displayed to customers
name_internalstringInternal reference name (not visible to customers)
package_dimensionsobjectShipping package dimensions
shippablebooleanWhether the product requires shipping
statement_descriptorstringText appearing on customer bank statements (max 22 chars)
unit_labelstringLabel for units (e.g. issues, seats)
countriesarrayGeographic availability by ISO country code
imagestringURL to product image
old_provider_idstringExternal product ID from a previous provider
import_unique_idstringUnique import identifier
revenue_recognition_strategyintegerRevenue recognition strategy (internal)
plansarrayAssociated pricing plans