Skip to main content
POST
Create a product or service
Creates a new product or service in the organization’s catalog for CFDI invoicing.

Authentication

Requires a valid Bearer token. The authenticated user must be an owner or admin of the organization.

Path Parameters

Request Body

Tax Object

Example Request

Example Response

Common Errors

400 Bad Request

Missing required fields or invalid values.

409 Conflict

A product with the same SKU already exists in this organization.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organizationId
string
required

Body

application/json
description
string
required

Product or service description

Example:

"Ukelele"

productKey
number
required

SAT product/service key (clave de producto o servicio)

Example:

60131324

price
number
required

Unit price

Example:

345.6

taxIncluded
boolean
default:false

Whether taxes are already included in the price

Example:

true

taxability
string
default:01

SAT taxability code (objeto de impuesto)

Example:

"01"

taxes
object[]

Applicable taxes

localTaxes
object[]

Applicable local taxes

unitKey
string
default:H87

SAT unit of measure key (clave de unidad)

Example:

"H87"

unitName
string
default:Elemento

Unit of measure name

Example:

"Elemento"

sku
string

Internal SKU or identifier

Example:

"UKL-001"

livemode
boolean
default:true

Whether this is a live mode product

Example:

true

Response

201 - application/json
id
string
required
Example:

"590ce6c56d04f840aa8438af"

organizationId
string
required
Example:

"org-uuid"

livemode
boolean
required
Example:

false

description
string
required
Example:

"Ukelele"

productKey
number
required
Example:

60131324

price
number
required
Example:

345.6

taxIncluded
boolean
required
Example:

true

taxability
string
required
Example:

"01"

taxes
object[]
required
localTaxes
object[]
required
unitKey
string
required
Example:

"H87"

unitName
string
required
Example:

"Elemento"

createdAt
string<date-time>
required
updatedAt
string<date-time>
required
sku
object
Example:

"UKL-001"