QuoteCloudCreate or update a product
When productId identifies a product in the company, that product is updated.
Permission
An OAuth access token with this scope. How to get a token
products:createCreate or update products.
Parameters
Not sure what to enter? Here’s where to find IDs.
client_idquery · stringrequiredThe Client ID of your OAuth client. It’s public, and goes on every request alongside your access token. Find it in QuoteCloud under Settings → API dashboard → Manage Integrations → OAuth Clients.Length at least 1.
Request body
Sent as application/json.
productIdstring or nullfolderNamestringrequiredsubfolderstring or nullsubfolder2string or nullskustring or nullcostvariesFields
Exactly one of these:
Option 1numberOption 2stringMatches
^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$. internalNamestringrequiredpricevariesrequiredFields
Exactly one of these:
Option 1numberOption 2stringMatches
^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$. lineItemNamestringrequireddescriptionNotesstring or nulldescriptionNotestring or nullDeprecated.
statusvariesrequiredBoolean coercion accepted by the v1 compatibility routes.
Fields
Exactly one of these:
Option 1booleanOption 2numberOne of
0, 1. Option 3stringOne of
true, false, 1, 0, yes, no, y, n. recipientCanEditQtyvariesBoolean coercion accepted by the v1 compatibility routes.
Fields
Exactly one of these:
Option 1booleanOption 2numberOne of
0, 1. Option 3stringOne of
true, false, 1, 0, yes, no, y, n. receipientCanEditQtyvariesBoolean coercion accepted by the v1 compatibility routes.Deprecated.
Fields
Exactly one of these:
Option 1booleanOption 2numberOne of
0, 1. Option 3stringOne of
true, false, 1, 0, yes, no, y, n. recipientCanEditTermvariesBoolean coercion accepted by the v1 compatibility routes.
Fields
Exactly one of these:
Option 1booleanOption 2numberOne of
0, 1. Option 3stringOne of
true, false, 1, 0, yes, no, y, n. receipientCanEditTermvariesBoolean coercion accepted by the v1 compatibility routes.Deprecated.
Fields
Exactly one of these:
Option 1booleanOption 2numberOne of
0, 1. Option 3stringOne of
true, false, 1, 0, yes, no, y, n. termBasedPricingvariesrequiredBoolean coercion accepted by the v1 compatibility routes.
Fields
Exactly one of these:
Option 1booleanOption 2numberOne of
0, 1. Option 3stringOne of
true, false, 1, 0, yes, no, y, n. termvariesFields
Exactly one of these:
Option 1numberOption 2stringMatches
^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$. defaultQtyvariesFields
Exactly one of these:
Option 1numberOption 2stringMatches
^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$. lockPricingLabelvariesrequiredBoolean coercion accepted by the v1 compatibility routes.
Fields
Exactly one of these:
Option 1booleanOption 2numberOne of
0, 1. Option 3stringOne of
true, false, 1, 0, yes, no, y, n. lockPricingValuevariesrequiredBoolean coercion accepted by the v1 compatibility routes.
Fields
Exactly one of these:
Option 1booleanOption 2numberOne of
0, 1. Option 3stringOne of
true, false, 1, 0, yes, no, y, n. lockTermValuevariesrequiredBoolean coercion accepted by the v1 compatibility routes.
Fields
Exactly one of these:
Option 1booleanOption 2numberOne of
0, 1. Option 3stringOne of
true, false, 1, 0, yes, no, y, n. lockPricingNotesvariesrequiredBoolean coercion accepted by the v1 compatibility routes.
Fields
Exactly one of these:
Option 1booleanOption 2numberOne of
0, 1. Option 3stringOne of
true, false, 1, 0, yes, no, y, n. imageUrl1string (uri) or nullimageUrl2string (uri) or nullimageUrl3string (uri) or nullimageUrl4string (uri) or nullimageUrl5string (uri) or null^customfield\d+$keys matching · anyNeeds one of recipientCanEditQty, receipientCanEditQty.
Needs one of recipientCanEditTerm, receipientCanEditTerm.
Responses
200Product created or updated.
dataobjectrequiredFields
statusstringrequiredAlways
success. messagestringrequiredproductobjectrequiredFields
idstringrequirednamestringrequiredskustringrequiredlineItemNamestringrequireddescriptionNotesstringrequiredpricenumberrequiredcostnumber or nullrequireddefaultQtynumberrequiredtermnumberrequiredtermBasedPricingbooleanstatusbooleanrequiredfolderNamestringimageImportobjectFields
requestedintegerrequiredValue 0 to 5.
uploadedintegerrequiredValue 0 to 5.
failedintegerrequiredValue 0 to 5.
appliedbooleanrequired400Invalid request or validation failure.
dataobjectrequiredFields
statusstringrequiredAlways
error. messagestringrequiredcodestringdocumentRefstringassetGenerationIdstringerrorsarray of objectItem fields
fieldstringrequiredmessagestringrequired401Missing or invalid bearer token or client ID.
errorstringrequirederror_descriptionstring403Insufficient scope, missing add-on, usage limit, or permission denial.
Exactly one of these:
OAuthError
errorstringrequirederror_descriptionstringApiErrorEnvelope
dataobjectrequiredFields
statusstringrequiredAlways
error. messagestringrequiredcodestringdocumentRefstringassetGenerationIdstringerrorsarray of objectItem fields
fieldstringrequiredmessagestringrequired429Shared company API request quota exceeded. Wait before retrying.
Retry-Afterheader · integerMinimum seconds to wait before retrying.Value at least 1.
dataobjectrequiredFields
statusstringrequiredAlways
error. messagestringrequiredretryAfterSecondsintegerrequiredValue at least 1.
Rate limit
120 requests a minute per company, shared across REST, Zapier and MCP. On a 429, wait for Retry-After.