Skip to main content
POST
Agregar elementos al catálogo de precios

Supported products

Autorizaciones

Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

FlowAuthorization Code
Authorization URL
https://app.hubspot.com/oauth/authorize
Token URL
https://api.hubapi.com/oauth/v1/token
Scopes2
inbounddb-product-library-read
price-book-write

Parámetros de ruta

priceBookId
integer<int64>
requerido

El identificador único del catálogo de precios al que se agregarán los elementos.

Cuerpo

application/json
productId
string
requerido

El identificador único del producto que se va a añadir al catálogo de precios. Es una cadena y es obligatorio.

Respuesta

successful operation

customProperties
object
requerido

Un mapa de nombres de propiedades personalizadas y sus valores para el elemento del catálogo de precios.

id
string
requerido

El identificador único del elemento del catálogo de precios.

productId
string
requerido

El identificador único del producto asociado al elemento del catálogo de precios.

archived
boolean

Un booleano que indica si el artículo del catálogo de precios está archivado.

archivedAt
string<date-time>

La fecha y hora en que se archivó el artículo del catálogo de precios, en formato ISO 8601.

billingFrequency
enum<string>

La frecuencia con la que se factura el artículo del catálogo de precios. Los valores válidos son "annually", "biweekly", "monthly", "one_time", "per_five_years", "per_four_years", "per_six_months", "per_three_years", "per_two_years", "quarterly" y "weekly".

Opciones disponibles:
ANNUALLY,
BIWEEKLY,
MONTHLY,
PER_FIVE_YEARS,
PER_FOUR_YEARS,
PER_SIX_MONTHS,
PER_THREE_YEARS,
PER_TWO_YEARS,
QUARTERLY,
WEEKLY
billingPeriod
string

El periodo de facturación del elemento del catálogo de precios.

costOfGoodsSold
string

El costo de los bienes vendidos para el artículo del catálogo de precios.

createdAt
string<date-time>

La fecha y hora en que se creó el elemento del catálogo de precios, en formato ISO 8601.

description
string

Una descripción del artículo del catálogo de precios.

images
string

Una cadena que representa las imágenes asociadas con el elemento del catálogo de precios.

name
string

El nombre del elemento del catálogo de precios.

priceBookId
string

El identificador único del catálogo de precios que contiene este artículo.

pricing
object
productClassification
enum<string>

La clasificación del producto. Los valores válidos incluyen "BUNDLE", "STANDALONE" y "VARIANT".

Opciones disponibles:
BUNDLE,
STANDALONE,
VARIANT
productType
enum<string>

El tipo de producto. Los valores válidos incluyen "INVENTORY", "NON_INVENTORY" y "SERVICE".

Opciones disponibles:
INVENTORY,
NON_INVENTORY,
SERVICE
recurringBillingTerms
enum<string>

Los términos de la facturación recurrente para el artículo del catálogo de precios. Los valores válidos incluyen "AUTOMATICALLY_RENEW" y "FIXED".

Opciones disponibles:
AUTOMATICALLY_RENEW,
FIXED
sku
string

La unidad de mantenimiento de existencias (SKU) del elemento del catálogo de precios.

status
enum<string>

El estado actual del elemento del catálogo de precios. Los valores válidos son "active" e "inactive".

Opciones disponibles:
active,
inactive
taxCategory
string

La categoría fiscal del elemento del catálogo de precios.

updatedAt
string<date-time>

La fecha y hora de la última actualización del elemento del catálogo de precios, en formato ISO 8601.

url
string

Una URL asociada al elemento del catálogo de precios.

Última modificación el 6 de octubre de 2026