Source: HighLevel API 2.0 Documentation Crawled: 2026-03-25
Source: https://marketplace.gohighlevel.com/docs/ghl/products/create-price-for-product/index.html
POST https://services.leadconnectorhq.com/products/:productId/price
The "Create Price for a Product" API allows adding a new price associated with a specific product to the system. Use this endpoint to create a price with the specified details for a particular product. Ensure that the required information is provided in the request payload.
products/prices.write
OAuth Access Token``Private Integration Token
Sub-Account Token``Agency Token
Request
Version stringrequired
Possible values: [2021-07-28]
API Version
productId stringrequired
ID of the product that needs to be used
Example: 6578278e879ad2646715ba9c
- application/json
name stringrequired
The name of the price.
Example:Price Name
type stringrequired
The type of the price.
Possible values: [one_time, recurring]
Example:one_time
currency stringrequired
The currency of the price.
Example:USD
amount numberrequired
The amount of the price. ( min: 0 )
Example:99.99
recurring object
The recurring details of the price (if type is recurring).
interval stringrequired
The interval at which the recurring event occurs.
Possible values: [day, month, week, year]
Example:day
intervalCount numberrequired
The number of intervals between each occurrence of the event.
Example:1
description string
A brief description of the price.
membershipOffers object[]
An array of membership offers associated with the price.
Array [
label stringrequired
Membership offer label
Example:top_50
value stringrequired
Membership offer label
Example:50
_id stringrequired
The unique identifier for the membership offer.
Example:655b33aa2209e60b6adb87a7
]
trialPeriod number
The trial period duration in days (if applicable).
Example:7
totalCycles number
The total number of billing cycles for the price. ( min: 1 )
Example:12
setupFee number
The setup fee for the price.
Example:10.99
variantOptionIds string[]
An array of variant option IDs associated with the price.
Example:["option_id_1","option_id_2"]
compareAtPrice number
The compare at price for the price.
Example:19.99
locationId stringrequired
The unique identifier of the location associated with the price.
Example:6578278e879ad2646715ba9c
userId string
The unique identifier of the user who created the price.
Example:6578278e879ad2646715ba9c
meta object
Additional metadata associated with the price.
source stringrequired
The source of the price.
Possible values: [stripe, woocommerce, shopify]
Example:stripe
sourceId string
The id of the source of the price from where it is imported
Example:123
stripePriceId stringrequired
The Stripe price ID associated with the price.
Example:price_123
internalSource stringrequired
The internal source of the price.
Possible values: [agency_plan, funnel, membership, communities, gokollab, calendar]
Example:agency_plan
trackInventory boolean
Need to track inventory stock quantity
Example:true
availableQuantity number
Available inventory stock quantity
Example:5
allowOutOfStockPurchases boolean
Continue selling when out of stock
Example:true
sku string
The unique identifier of the SKU associated with the price
Example:sku_123
shippingOptions object
Shipping options of the Price
weight object
Weight options of the product
value numberrequired
Actual weight of the product
Example:10
unit stringrequired
Weight unit of the product
Possible values: [kg, lb, g, oz]
Example:kg
dimensions object
Dimensions of the product
height numberrequired
Height of the price
Example:10
width numberrequired
Width of the price
Example:10
length numberrequired
Length of the price
Example:10
unit stringrequired
Unit of the price dimensions
Possible values: [cm, in, m]
Example:cm
isDigitalProduct boolean
Is the product a digital product
Example:true
digitalDelivery string[]
Digital delivery options
Responses
- 201
- 400
- 401
- 422
Successful response
-
application/json
-
Schema
-
Example (auto)
Schema
_id stringrequired
The unique identifier for the price.
Example:655b33aa2209e60b6adb87a7
membershipOffers object[]
An array of membership offers associated with the price.
Array [
label stringrequired
Membership offer label
Example:top_50
value stringrequired
Membership offer label
Example:50
_id stringrequired
The unique identifier for the membership offer.
Example:655b33aa2209e60b6adb87a7
]
variantOptionIds string[]
An array of variant option IDs associated with the price.
Example:["h4z7u0im2q8","h3nst2ltsnn"]
locationId string
The unique identifier for the location.
Example:3SwdhCsvxI8Au3KsPJt6
product string
The unique identifier for the associated product.
Example:655b33a82209e60b6adb87a5
userId string
The unique identifier for the user.
Example:6YAtzfzpmHAdj0e8GkKp
name stringrequired
The name of the price.
Example:Red / S
type stringrequired
The type of the price (e.g., one_time).
Possible values: [one_time, recurring]
Example:one_time
currency stringrequired
The currency code for the price.
Example:INR
amount numberrequired
The amount of the price.
Example:199999
recurring object
The recurring details of the price (if type is recurring).
interval stringrequired
The interval at which the recurring event occurs.
Possible values: [day, month, week, year]
Example:day
intervalCount numberrequired
The number of intervals between each occurrence of the event.
Example:1
createdAt date-time
The creation timestamp of the price.
Example:2023-11-20T10:23:38.645Z
updatedAt date-time
The last update timestamp of the price.
Example:2024-01-23T09:57:04.852Z
compareAtPrice number
The compare-at price for comparison purposes.
Example:2000000
trackInventory boolean
Indicates whether inventory tracking is enabled.
Example:null
availableQuantity number
Available inventory stock quantity
Example:5
allowOutOfStockPurchases boolean
Continue selling when out of stock
Example:true
{
"_id": "655b33aa2209e60b6adb87a7",
"membershipOffers": [\
{\
"label": "top_50",\
"value": "50",\
"_id": "655b33aa2209e60b6adb87a7"\
}\
],
"variantOptionIds": [\
"h4z7u0im2q8",\
"h3nst2ltsnn"\
],
"locationId": "3SwdhCsvxI8Au3KsPJt6",
"product": "655b33a82209e60b6adb87a5",
"userId": "6YAtzfzpmHAdj0e8GkKp",
"name": "Red / S",
"type": "one_time",
"currency": "INR",
"amount": 199999,
"recurring": {
"interval": "day",
"intervalCount": 1
},
"createdAt": "2023-11-20T10:23:38.645Z",
"updatedAt": "2024-01-23T09:57:04.852Z",
"compareAtPrice": 2000000,
"trackInventory": null,
"availableQuantity": 5,
"allowOutOfStockPurchases": true
}Bad Request
-
application/json
-
Schema
-
Example (auto)
Schema
statusCode number
Example:400
message string
Example:Bad Request
{
"statusCode": 400,
"message": "Bad Request"
}Unauthorized
-
application/json
-
Schema
-
Example (auto)
Schema
statusCode number
Example:401
message string
Example:Invalid token: access token is invalid
error string
Example:Unauthorized
{
"statusCode": 401,
"message": "Invalid token: access token is invalid",
"error": "Unauthorized"
}Unprocessable Entity
-
application/json
-
Schema
-
Example (auto)
Schema
statusCode number
Example:422
message string[]
Example:["Unprocessable Entity"]
error string
Example:Unprocessable Entity
{
"statusCode": 422,
"message": [\
"Unprocessable Entity"\
],
"error": "Unprocessable Entity"
}name: Authorizationtype: httpscopes: products/prices.writescheme: bearerbearerFormat: JWTin: headerdescription: Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.
-
curl
-
nodejs
-
python
-
php
-
java
-
go
-
ruby
-
powershell
-
CURL
curl -L 'https://services.leadconnectorhq.com/products/:productId/price' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
"name": "Price Name",
"type": "one_time",
"currency": "USD",
"amount": 99.99,
"recurring": {
"interval": "day",
"intervalCount": 1
},
"description": "string",
"membershipOffers": [\
{\
"label": "top_50",\
"value": "50",\
"_id": "655b33aa2209e60b6adb87a7"\
}\
],
"trialPeriod": 7,
"totalCycles": 12,
"setupFee": 10.99,
"variantOptionIds": [\
"option_id_1",\
"option_id_2"\
],
"compareAtPrice": 19.99,
"locationId": "6578278e879ad2646715ba9c",
"userId": "6578278e879ad2646715ba9c",
"meta": {
"source": "stripe",
"sourceId": "123",
"stripePriceId": "price_123",
"internalSource": "agency_plan"
},
"trackInventory": true,
"availableQuantity": 5,
"allowOutOfStockPurchases": true,
"sku": "sku_123",
"shippingOptions": {
"weight": {
"value": 10,
"unit": "kg"
},
"dimensions": {
"height": 10,
"width": 10,
"length": 10,
"unit": "cm"
}
},
"isDigitalProduct": true,
"digitalDelivery": [\
"string"\
]
}'Request Collapse all
Base URL
Edit
https://services.leadconnectorhq.com
Auth
Security Scheme
Location-AccessAgency-Access
Bearer Token
Parameters
productId — pathrequired
Version — headerrequired
---2021-07-28
Body required
{
"name": "Price Name",
"type": "one_time",
"currency": "USD",
"amount": 99.99,
"recurring": {
"interval": "day",
"intervalCount": 1
},
"description": "string",
"membershipOffers": [\
{\
"label": "top_50",\
"value": "50",\
"_id": "655b33aa2209e60b6adb87a7"\
}\
],
"trialPeriod": 7,
"totalCycles": 12,
"setupFee": 10.99,
"variantOptionIds": [\
"option_id_1",\
"option_id_2"\
],
"compareAtPrice": 19.99,
"locationId": "6578278e879ad2646715ba9c",
"userId": "6578278e879ad2646715ba9c",
"meta": {
"source": "stripe",
"sourceId": "123",
"stripePriceId": "price_123",
"internalSource": "agency_plan"
},
"trackInventory": true,
"availableQuantity": 5,
"allowOutOfStockPurchases": true,
"sku": "sku_123",
"shippingOptions": {
"weight": {
"value": 10,
"unit": "kg"
},
"dimensions": {
"height": 10,
"width": 10,
"length": 10,
"unit": "cm"
}
},
"isDigitalProduct": true,
"digitalDelivery": [\
"string"\
]
}Send API Request
ResponseClear
Click the Send API Request button above and see the response here!
Source: https://marketplace.gohighlevel.com/docs/ghl/products/create-product/index.html
POST https://services.leadconnectorhq.com/products/
The "Create Product" API allows adding a new product to the system. Use this endpoint to create a product with the specified details. Ensure that the required information is provided in the request payload.
products.write
OAuth Access Token``Private Integration Token
Sub-Account Token``Agency Token
Request
Version stringrequired
Possible values: [2021-07-28]
API Version
- application/json
name stringrequired
The name of the product.
Example:Awesome Product
locationId stringrequired
The unique identifier for the location.
Example:3SwdhCsvxI8Au3KsPJt6
description string
A brief description of the product.
Example:Product description goes here.
productType stringrequired
Possible values: [DIGITAL, PHYSICAL, SERVICE, PHYSICAL/DIGITAL]
image string
The URL for the product image.
Example:https://storage.googleapis.com/ghl-test/3SwdhCsvxI8Au3KsPJt6/media/65af8d5df88bdb4b1022ee90.png
statementDescriptor string
The statement descriptor for the product.
Example:abcde
availableInStore boolean
Indicates whether the product is available in-store.
Example:true
medias object[]
An array of medias for the product.
Array [
id stringrequired
The unique identifier for the media.
Example:fzrgusiuu0m
title string
The title of the media file.
Example:1dd7dcd0-e71d-4cf7-a06b-6d47723d6a29.png
url stringrequired
The URL where the media file is stored.
Example:https://storage.googleapis.com/ghl-test/3SwdhCsvxI8Au3KsPJt6/media/sample.png
type stringrequired
The type of the media file (e.g., image, video will be supporting soon).
Possible values: [image, video]
Example:image
isFeatured boolean
Indicates whether the media is featured.
Example:true
priceIds array[]
Mongo ObjectIds of the prices for which the media is assigned
Example:6578278e879ad2646715ba9c
]
variants object[]
An array of variants for the product.
Array [
id stringrequired
A unique identifier for the variant.
Example:38s63qmxfr4
name stringrequired
The name of the variant.
Example:Size
options object[]required
An array of options for the variant.
Array [
id stringrequired
The unique identifier for the option.
Example:h4z7u0im2q8
name stringrequired
The name of the option.
Example:XL
]
]
collectionIds string[]
An array of category Ids for the product
Example:["65d71377c326ea78e1c47df5","65d71377c326ea78e1c47d34"]
isTaxesEnabled boolean
Are there any taxes attached to the product. If this is true, taxes array cannot be empty.
Default value: false
Example:true
taxes string[]
List of ids of Taxes attached to the Product. If taxes are passed, isTaxesEnabled should be true.
Example:["654492a4e6bef380114de15a"]
automaticTaxCategoryId string
Tax category ID for Automatic taxes calculation.
Example:65d71377c326ea78e1c47df5
isLabelEnabled boolean
Is the product label enabled. If this is true, label object cannot be empty.
Default value: false
Example:true
label object
Details for Product Label
title stringrequired
The content for the product label.
Example:Featured
startDate string
Start date in YYYY-MM-DDTHH:mm:ssZ format
Example:2024-06-26T05:43:35.000Z
endDate string
Start date in YYYY-MM-DDTHH:mm:ssZ format
Example:2024-06-30T05:43:39.000Z
slug string
The slug using which the product navigation will be handled
Example:awesome-product
seo object
SEO data for the product that will be displayed in the preview
title string
SEO title
Example:Best Product - Buy Now
description string
SEO description
Example:This is the best product you can buy online with amazing features and great value
taxInclusive boolean
Whether the taxes should be included in the purchase price
Default value: false
Example:true
Responses
- 201
- 400
- 401
- 422
Successful response
-
application/json
-
Schema
-
Example (auto)
Schema
_id stringrequired
The unique identifier for the product.
Example:655b33a82209e60b6adb87a5
description string
product description
Example:This is a really awesome product
variants object[]
An array of variants for the product.
Array [
id stringrequired
A unique identifier for the variant.
Example:38s63qmxfr4
name stringrequired
The name of the variant.
Example:Size
options object[]required
An array of options for the variant.
Array [
id stringrequired
The unique identifier for the option.
Example:h4z7u0im2q8
name stringrequired
The name of the option.
Example:XL
]
]
locationId stringrequired
The unique identifier for the location.
Example:3SwdhCsvxI8Au3KsPJt6
name stringrequired
The name of the product.
Example:Awesome Product
productType stringrequired
The type of the product (e.g., PHYSICAL).
Example:PHYSICAL
availableInStore boolean
Indicates whether the product is available in-store.
Example:true
createdAt date-timerequired
The creation timestamp of the product.
Example:2023-11-20T10:23:36.515Z
updatedAt date-timerequired
The last update timestamp of the product.
Example:2024-01-23T09:57:04.846Z
statementDescriptor string
The statement descriptor for the product.
Example:abcde
image string
The URL for the product image.
Example:https://storage.googleapis.com/ghl-test/3SwdhCsvxI8Au3KsPJt6/media/65af8d5df88bdb4b1022ee90.png
collectionIds string[]
An array of category Ids for the product
Example:["65d71377c326ea78e1c47df5","65d71377c326ea78e1c47d34"]
isTaxesEnabled boolean
The field indicates whether taxes are enabled for the product or not.
Default value: false
Example:true
taxes string[]
An array of ids of Taxes attached to the Product. If the expand query includes tax, the taxes will be of type ProductTaxDto. Please refer to the ProductTaxDto for additional details.
Example:["654492a4e6bef380114de15a"]
automaticTaxCategoryId string
Tax category ID for Automatic taxes calculation.
Example:65d71377c326ea78e1c47df5
label object
The Product label details
title stringrequired
The content for the product label.
Example:Featured
startDate string
Start date in YYYY-MM-DDTHH:mm:ssZ format
Example:2024-06-26T05:43:35.000Z
endDate string
Start date in YYYY-MM-DDTHH:mm:ssZ format
Example:2024-06-30T05:43:39.000Z
slug string
The slug of the product by which the product will be navigated
Example:washing-machine
{
"_id": "655b33a82209e60b6adb87a5",
"description": "This is a really awesome product",
"variants": [\
{\
"id": "38s63qmxfr4",\
"name": "Size",\
"options": [\
{\
"id": "h4z7u0im2q8",\
"name": "XL"\
}\
]\
}\
],
"locationId": "3SwdhCsvxI8Au3KsPJt6",
"name": "Awesome Product",
"productType": "PHYSICAL",
"availableInStore": true,
"createdAt": "2023-11-20T10:23:36.515Z",
"updatedAt": "2024-01-23T09:57:04.846Z",
"statementDescriptor": "abcde",
"image": "https://storage.googleapis.com/ghl-test/3SwdhCsvxI8Au3KsPJt6/media/65af8d5df88bdb4b1022ee90.png",
"collectionIds": [\
"65d71377c326ea78e1c47df5",\
"65d71377c326ea78e1c47d34"\
],
"isTaxesEnabled": true,
"taxes": [\
"654492a4e6bef380114de15a"\
],
"automaticTaxCategoryId": "65d71377c326ea78e1c47df5",
"label": {
"title": "Featured",
"startDate": "2024-06-26T05:43:35.000Z",
"endDate": "2024-06-30T05:43:39.000Z"
},
"slug": "washing-machine"
}Bad Request
-
application/json
-
Schema
-
Example (auto)
Schema
statusCode number
Example:400
message string
Example:Bad Request
{
"statusCode": 400,
"message": "Bad Request"
}Unauthorized
-
application/json
-
Schema
-
Example (auto)
Schema
statusCode number
Example:401
message string
Example:Invalid token: access token is invalid
error string
Example:Unauthorized
{
"statusCode": 401,
"message": "Invalid token: access token is invalid",
"error": "Unauthorized"
}Unprocessable Entity
-
application/json
-
Schema
-
Example (auto)
Schema
statusCode number
Example:422
message string[]
Example:["Unprocessable Entity"]
error string
Example:Unprocessable Entity
{
"statusCode": 422,
"message": [\
"Unprocessable Entity"\
],
"error": "Unprocessable Entity"
}name: Authorizationtype: httpscopes: products.writescheme: bearerbearerFormat: JWTin: headerdescription: Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.
-
curl
-
nodejs
-
python
-
php
-
java
-
go
-
ruby
-
powershell
-
CURL
curl -L 'https://services.leadconnectorhq.com/products/' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
"name": "Awesome Product",
"locationId": "3SwdhCsvxI8Au3KsPJt6",
"description": "Product description goes here.",
"productType": "DIGITAL",
"image": "https://storage.googleapis.com/ghl-test/3SwdhCsvxI8Au3KsPJt6/media/65af8d5df88bdb4b1022ee90.png",
"statementDescriptor": "abcde",
"availableInStore": true,
"medias": [\
{\
"id": "fzrgusiuu0m",\
"title": "1dd7dcd0-e71d-4cf7-a06b-6d47723d6a29.png",\
"url": "https://storage.googleapis.com/ghl-test/3SwdhCsvxI8Au3KsPJt6/media/sample.png",\
"type": "image",\
"isFeatured": true,\
"priceIds": "6578278e879ad2646715ba9c"\
}\
],
"variants": [\
{\
"id": "38s63qmxfr4",\
"name": "Size",\
"options": [\
{\
"id": "h4z7u0im2q8",\
"name": "XL"\
}\
]\
}\
],
"collectionIds": [\
"65d71377c326ea78e1c47df5",\
"65d71377c326ea78e1c47d34"\
],
"isTaxesEnabled": true,
"taxes": [\
"654492a4e6bef380114de15a"\
],
"automaticTaxCategoryId": "65d71377c326ea78e1c47df5",
"isLabelEnabled": true,
"label": {
"title": "Featured",
"startDate": "2024-06-26T05:43:35.000Z",
"endDate": "2024-06-30T05:43:39.000Z"
},
"slug": "awesome-product",
"seo": {
"title": "Best Product - Buy Now",
"description": "This is the best product you can buy online with amazing features and great value"
},
"taxInclusive": true
}'Request Collapse all
Base URL
Edit
https://services.leadconnectorhq.com
Auth
Security Scheme
Location-AccessAgency-Access
Bearer Token
Parameters
Version — headerrequired
---2021-07-28
Body required
{
"name": "Awesome Product",
"locationId": "3SwdhCsvxI8Au3KsPJt6",
"description": "Product description goes here.",
"productType": "DIGITAL",
"image": "https://storage.googleapis.com/ghl-test/3SwdhCsvxI8Au3KsPJt6/media/65af8d5df88bdb4b1022ee90.png",
"statementDescriptor": "abcde",
"availableInStore": true,
"medias": [\
{\
"id": "fzrgusiuu0m",\
"title": "1dd7dcd0-e71d-4cf7-a06b-6d47723d6a29.png",\
"url": "https://storage.googleapis.com/ghl-test/3SwdhCsvxI8Au3KsPJt6/media/sample.png",\
"type": "image",\
"isFeatured": true,\
"priceIds": "6578278e879ad2646715ba9c"\
}\
],
"variants": [\
{\
"id": "38s63qmxfr4",\
"name": "Size",\
"options": [\
{\
"id": "h4z7u0im2q8",\
"name": "XL"\
}\
]\
}\
],
"collectionIds": [\
"65d71377c326ea78e1c47df5",\
"65d71377c326ea78e1c47d34"\
],
"isTaxesEnabled": true,
"taxes": [\
"654492a4e6bef380114de15a"\
],
"automaticTaxCategoryId": "65d71377c326ea78e1c47df5",
"isLabelEnabled": true,
"label": {
"title": "Featured",
"startDate": "2024-06-26T05:43:35.000Z",
"endDate": "2024-06-30T05:43:39.000Z"
},
"slug": "awesome-product",
"seo": {
"title": "Best Product - Buy Now",
"description": "This is the best product you can buy online with amazing features and great value"
},
"taxInclusive": true
}Send API Request
ResponseClear
Click the Send API Request button above and see the response here!
Source: https://marketplace.gohighlevel.com/docs/ghl/products/list-products
Page Not Found
The page you are looking for doesn't exist or has been moved.
Go to Home Go Back
Source: https://marketplace.gohighlevel.com/docs/ghl/products/products-api/index.html
Version: 1.0
Documentation for products API
Authentication
- HTTP: Bearer Auth
- HTTP: Bearer Auth
- HTTP: Bearer Auth
- HTTP: Bearer Auth
- HTTP: Bearer Auth
Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.
| Security Scheme Type: | http | | HTTP Authorization Scheme: | bearer | | Bearer format: | JWT |
Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.
| Security Scheme Type: | http | | HTTP Authorization Scheme: | bearer | | Bearer format: | JWT |
Use the Access Token generated with user type as Sub-Account.
| Security Scheme Type: | http | | HTTP Authorization Scheme: | bearer | | Bearer format: | JWT |
Use the Access Token generated with user type as Agency (OR) Private Integration Token of Agency.
| Security Scheme Type: | http | | HTTP Authorization Scheme: | bearer | | Bearer format: | JWT |
Use the Access Token generated with user type as Agency.
| Security Scheme Type: | http | | HTTP Authorization Scheme: | bearer | | Bearer format: | JWT |