> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
---
id: fc337a04-27a0-4af2-928a-7e2d59a67d4a
---
# Validate a price book
> Validate a specific price book in your HubSpot account. This endpoint checks the integrity and correctness of the price book identified by the given priceBookId. Use this to ensure that the price book meets all necessary criteria before proceeding with further operations.
export const ScopesList = ({scopes = [], description = "This API requires one of the following scopes:"}) => {
if (!scopes || scopes.length === 0) {
return null;
}
const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
return
;
};
## OpenAPI
````yaml specs/2026-09/commerce-price-books-v2026-09.json POST /commerce/price-books/2026-09/price-books/{priceBookId}/validate
openapi: 3.0.1
info:
title: Commerce Price Books
description: Basepom for all HubSpot Projects
version: 2026-09
x-hubspot-product-tier-requirements:
marketing: FREE
sales: FREE
service: FREE
cms: FREE
commerce: FREE
crmHub: FREE
dataHub: FREE
servers:
- url: https://api.hubapi.com
security: []
tags:
- name: Advanced
- name: Basic
- name: Batch
- name: Items
paths:
/commerce/price-books/2026-09/price-books/{priceBookId}/validate:
post:
tags:
- Basic
summary: Validate price book
description: >-
Validate a specific price book in your HubSpot account. This endpoint
checks the integrity and correctness of the price book identified by the
given priceBookId. Use this to ensure that the price book meets all
necessary criteria before proceeding with further operations.
operationId: post-/commerce/price-books/2026-09/price-books/{priceBookId}/validate
parameters:
- name: priceBookId
in: path
description: The unique identifier of the price book to validate.
required: true
style: simple
explode: false
schema:
type: integer
format: int64
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/PriceBookValidateResponse'
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- price-book-read
components:
schemas:
PriceBookValidateResponse:
required:
- errors
- isValid
type: object
properties:
errors:
type: array
description: >-
An array of ErrorDetail objects providing information about any
errors encountered during validation.
items:
$ref: '#/components/schemas/ErrorDetail'
isValid:
type: boolean
description: A boolean indicating whether the price book is valid.
ErrorDetail:
required:
- message
type: object
properties:
code:
type: string
description: The status code associated with the error detail.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Context about the error condition, which may include additional
information such as missing scopes or invalid property names.
example: '{missingScopes=[scope1, scope2]}'
in:
type: string
description: The name of the field or parameter in which the error was found.
message:
type: string
description: >-
A human readable message describing the error along with remediation
steps where appropriate. This is a required property.
subCategory:
type: string
description: >-
A specific category that contains more specific detail about the
error.
description: >-
Represents detailed information about an error that occurred in the API.
This component is used to provide additional context and specifics about
errors, typically as part of an error response.
Error:
required:
- category
- correlationId
- message
type: object
properties:
category:
type: string
description: The error category, represented as a string.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
An object providing context about the error condition. It contains
additional properties, each being an array of strings.
example: >-
{invalidPropertyName=[propertyValue], missingScopes=[scope1,
scope2]}
correlationId:
type: string
description: >-
A unique identifier for the request, represented as a UUID string.
Include this value with any error reports or support tickets.
format: uuid
example: aeb5f871-7f07-4993-9211-075dc63e7cbf
errors:
type: array
description: >-
An array providing further information about the error, with each
item being an ErrorDetail object.
items:
$ref: '#/components/schemas/ErrorDetail'
links:
type: object
additionalProperties:
type: string
description: >-
An object that maps link names to associated URIs containing
documentation about the error or recommended remediation steps. Each
property is a string.
message:
type: string
description: >-
A human readable message describing the error along with remediation
steps where appropriate. It is a string.
example: An error occurred
subCategory:
type: string
description: >-
A specific category that contains more specific detail about the
error, represented as a string.
description: >-
Represents an error response returned by the API when an operation
fails. This component is used in various endpoints to provide detailed
information about the error encountered.
example:
message: Invalid input (details will vary based on the error)
correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
category: VALIDATION_ERROR
links:
knowledge-base: https://www.hubspot.com/products/service/knowledge-base
responses:
Error:
description: An error occurred.
content:
'*/*':
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://app.hubspot.com/oauth/authorize
tokenUrl: https://api.hubapi.com/oauth/v1/token
scopes:
crm.objects.products.read: ''
price-book-read: ''
price-book-write: ''
````
{product.name} -
{product.level}
)}