> ## 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: dcf328f3-5f28-4b32-b3f0-44a4f403285a --- # Get the details for multiple properties > Retrieve a batch of properties for a specified object type within a given app. This endpoint is useful for fetching multiple properties efficiently in a single request, especially when dealing with large datasets or when specific properties are needed for processing. export const SupportedProducts = ({marketing, sales, service, cms, data, commerce, crm, marketingLevel, salesLevel, serviceLevel, cmsLevel, dataLevel, commerceLevel, crmLevel}) => { const translations = { description: "Requires one of the following products or higher.", productNames: { marketing: "Marketing Hub", sales: "Sales Hub", service: "Service Hub", cms: "Content Hub", data: "Data Hub", commerce: "Revenue Hub", crm: "Smart CRM" }, tiers: { free: "Free", starter: "Starter", professional: "Professional", enterprise: "Enterprise" } }; const translateTier = tier => { if (!tier) return ''; const lowerTier = tier.toLowerCase(); return translations.tiers[lowerTier] || tier; }; const products = [{ name: marketing ? translations.productNames.marketing : '', level: translateTier(marketingLevel), icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/MarketingHub.svg", alt: "Marketing Hub" }, { name: sales ? translations.productNames.sales : '', level: translateTier(salesLevel), icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/SalesHub.svg", alt: "Sales Hub" }, { name: service ? translations.productNames.service : '', level: translateTier(serviceLevel), icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/ServiceHub.svg", alt: "Service Hub" }, { name: cms ? translations.productNames.cms : '', level: translateTier(cmsLevel), icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/ContentHub.svg", alt: "Content Hub" }, { name: data ? translations.productNames.data : '', level: translateTier(dataLevel), icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/DataHub.svg", alt: "Data Hub" }, { name: commerce ? translations.productNames.commerce : '', level: translateTier(commerceLevel), icon: "https://www.hubspot.com/hubfs/Knowledge_Base/subscription_key_icons/commerce_icon.svg", alt: "Revenue Hub" }, { name: crm ? translations.productNames.crm : '', level: translateTier(crmLevel), icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/SmartCRM.svg", alt: "Smart CRM" }].filter(product => product.name && product.level); if (products.length === 0) return null; return
{translations.description}
{products.map((product, index) =>
{product.alt} {product.name} - {product.level}
)}
; }; ## OpenAPI ````yaml specs/2026-03/cms-media-bridge-v2026-03.json POST /media-bridge/2026-03/{appId}/properties/{objectType}/batch/read openapi: 3.0.1 info: title: CMS Media Bridge description: Basepom for all HubSpot Projects version: 2026-03 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 paths: /media-bridge/2026-03/{appId}/properties/{objectType}/batch/read: post: tags: - Batch summary: Batch read properties description: >- Retrieve a batch of properties for a specified object type within a given app. This endpoint is useful for fetching multiple properties efficiently in a single request, especially when dealing with large datasets or when specific properties are needed for processing. operationId: post-/media-bridge/2026-03/{appId}/properties/{objectType}/batch/read parameters: - name: appId in: path description: '' required: true style: simple explode: false schema: type: integer format: int32 - name: objectType in: path description: '' required: true style: simple explode: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/BatchReadInputPropertyName' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/BatchResponseProperty' '207': description: multiple statuses content: application/json: schema: $ref: '#/components/schemas/BatchResponsePropertyWithErrors' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - developers-read components: schemas: BatchReadInputPropertyName: required: - archived - dataSensitivity - inputs type: object properties: archived: type: boolean description: >- A boolean indicating whether to include archived properties in the batch read. Defaults to false if not specified. dataSensitivity: type: string description: >- A string representing the sensitivity level of the data being accessed. This property helps in determining the security measures needed for handling the data. enum: - highly_sensitive - non_sensitive - sensitive inputs: type: array description: >- An array of strings, each representing a property name to be included in the batch read operation. items: $ref: '#/components/schemas/PropertyName' BatchResponseProperty: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- The date and time when the batch operation was completed, in ISO 8601 format. format: date-time links: type: object additionalProperties: type: string description: >- A collection of links related to the batch operation, typically used for navigation or additional actions. requestedAt: type: string description: >- The date and time when the batch operation was requested, in ISO 8601 format. format: date-time results: type: array description: >- An array containing the results of the batch operation, detailing the outcome for each property involved. items: $ref: '#/components/schemas/Property' startedAt: type: string description: >- The date and time when the batch operation began, in ISO 8601 format. format: date-time status: type: string description: >- The current status of the batch operation, indicating success or failure. enum: - CANCELED - COMPLETE - PENDING - PROCESSING BatchResponsePropertyWithErrors: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- The date and time when the batch operation was completed, in ISO 8601 format. format: date-time errors: type: array description: >- An array containing error details for properties that failed during the batch operation. items: $ref: '#/components/schemas/StandardError' links: type: object additionalProperties: type: string description: >- A collection of links related to the batch operation, typically used for navigation or further actions. numErrors: type: integer description: The number of errors encountered during the batch operation. format: int32 requestedAt: type: string description: >- The date and time when the batch operation was requested, in ISO 8601 format. format: date-time results: type: array description: >- An array containing the results of the batch operation, detailing each property's operation outcome. items: $ref: '#/components/schemas/Property' startedAt: type: string description: >- The date and time when the batch operation started, in ISO 8601 format. format: date-time status: type: string description: >- The overall status of the batch operation, indicating success or failure. enum: - CANCELED - COMPLETE - PENDING - PROCESSING PropertyName: required: - name type: object properties: name: type: string description: A string representing the name of the property. Property: required: - allowedObjectTypes - calculated - canArchive - canRestore - createdAt - createdUserId - currencyPropertyName - dataSensitivity - dateDisplayHint - deleted - description - displayMode - displayOrder - enforceMultivalueUniqueness - externalOptions - externalOptionsReferenceType - favorited - favoritedOrder - fieldType - formField - fromUserId - groupName - hasUniqueValue - hidden - hubspotDefined - isCustomizedDefault - isMultiValued - isPartial - label - mutableDefinitionNotDeletable - name - numberDisplayHint - optionSortStrategy - options - optionsAreMutable - owningAppId - portalId - readOnlyDefinition - readOnlyValue - referencedObjectType - searchTextAnalysisMode - searchableInGlobalSearch - sensitiveDataCategories - showCurrencySymbol - textDisplayHint - type - updatedAt type: object properties: allowedObjectTypes: type: array description: >- An array of strings representing the object types that are allowed for this property. items: $ref: '#/components/schemas/ObjectTypeIdProto' calculated: type: boolean description: A boolean indicating if the property is calculated. canArchive: type: boolean description: A boolean indicating if the property can be archived. canRestore: type: boolean description: A boolean indicating if the property can be restored. createdAt: type: integer description: >- A string representing the date and time when the property was created, in ISO 8601 format. format: int64 createdUserId: type: integer description: A string representing the user ID who created the property. format: int64 currencyPropertyName: type: string description: >- A string representing the name of the currency property associated with this property. dataSensitivity: type: string description: A string indicating the sensitivity level of the data. enum: - high - none - standard dateDisplayHint: type: string description: A string providing a hint for displaying dates. enum: - absolute - absolute_with_relative - time_since - time_until deleted: type: boolean description: A boolean indicating if the property has been deleted. description: type: string description: A string providing a description of the property. displayMode: type: string description: A string indicating the display mode of the property. enum: - all_unique_versions - current_value displayOrder: type: integer description: An integer specifying the order in which the property is displayed. format: int32 enforceMultivalueUniqueness: type: boolean description: >- A boolean indicating if uniqueness is enforced for multivalue properties. externalOptions: type: boolean description: A boolean indicating if the property has external options. externalOptionsReferenceType: type: string description: A string indicating the reference type for external options. favorited: type: boolean description: A boolean indicating if the property is marked as a favorite. favoritedOrder: type: integer description: An integer specifying the order of the property among favorites. format: int32 fieldType: type: string description: >- A string indicating the field type of the property, such as 'booleancheckbox', 'calculation_equation', 'checkbox', 'date', 'file', 'html', 'number', 'phonenumber', 'radio', 'select', 'text', or 'textarea'. formField: type: boolean description: A boolean indicating whether the property is used as a form field. fromUserId: type: integer description: >- A string representing the user ID from which the property originates. format: int64 groupName: type: string description: >- A string representing the name of the group to which the property belongs. hasUniqueValue: type: boolean description: A boolean indicating if the property has a unique value. hidden: type: boolean description: A boolean indicating whether the property is hidden. example: false hubspotDefined: type: boolean description: A boolean indicating if the property is defined by HubSpot. isCustomizedDefault: type: boolean description: A boolean indicating if the property is a customized default. isMultiValued: type: boolean description: A boolean indicating if the property can have multiple values. isPartial: type: boolean description: A boolean indicating if the property is partial. label: type: string description: >- A string representing the label of the property, used for display purposes. mutableDefinitionNotDeletable: type: boolean description: >- A boolean indicating if the property definition is mutable but not deletable. name: type: string description: A string representing the name of the property. numberDisplayHint: type: string description: >- A string providing a hint for displaying numbers, with options like 'unformatted', 'formatted', 'currency', 'percentage', 'duration', or 'probability'. enum: - currency - duration - formatted - percentage - probability - unformatted optionSortStrategy: type: string description: A string indicating the strategy used to sort options. enum: - ALPHABETICAL - DISPLAY_ORDER options: type: array description: >- An array of options available for the property, applicable if the property type supports options. items: $ref: '#/components/schemas/Option' optionsAreMutable: type: boolean description: A boolean indicating if the options for the property are mutable. owningAppId: type: integer description: An integer representing the ID of the app that owns the property. format: int64 portalId: type: integer description: An integer representing the unique identifier for the portal. format: int64 readOnlyDefinition: type: boolean description: A boolean indicating if the property's definition is read-only. readOnlyValue: type: boolean description: A boolean indicating if the property's value is read-only. referencedObjectType: type: string description: A string indicating the type of object referenced by the property. enum: - ABANDONED_CART - ACCEPTANCE_TEST - AD - AD_ACCOUNT - AD_CAMPAIGN - AD_GROUP - AI_FORECAST - ALL_PAGES - APPROVAL - APPROVAL_STEP - ATTRIBUTION - AUDIENCE - AUTOMATION_JOURNEY - AUTOMATION_PLATFORM_FLOW - AUTOMATION_PLATFORM_FLOW_ACTION - BET_ALERT - BET_DELIVERABLE_SERVICE - BLOG_LISTING_PAGE - BLOG_POST - CALL - CAMPAIGN - CAMPAIGN_BUDGET_ITEM - CAMPAIGN_SPEND_ITEM - CAMPAIGN_STEP - CAMPAIGN_TEMPLATE - CAMPAIGN_TEMPLATE_STEP - CART - CASE_STUDY - CHATFLOW - CLIP - CMS_URL - COMBO_EVENT_CONFIGURATION - COMMERCE_PAYMENT - COMMUNICATION - COMPANY - CONTACT - CONTACT_CREATE_ATTRIBUTION - CONTENT - CONTENT_AUDIT - CONTENT_AUDIT_PAGE - CONVERSATION - CONVERSATION_INBOX - CONVERSATION_SESSION - CRM_OBJECTS_DUMMY_TYPE - CRM_PIPELINES_DUMMY_TYPE - CTA - CTA_VARIANT - DATA_PRIVACY_CONSENT - DATA_SYNC_STATE - DEAL - DEAL_CREATE_ATTRIBUTION - DEAL_REGISTRATION - DEAL_SPLIT - DISCOUNT - DISCOUNT_CODE - DISCOUNT_TEMPLATE - EMAIL - ENGAGEMENT - EXPORT - EXTERNAL_WEB_URL - FEE - FEEDBACK_SUBMISSION - FEEDBACK_SURVEY - FILE_MANAGER_FILE - FILE_MANAGER_FOLDER - FOLDER - FORECAST - FORM - FORM_SUBMISSION_INBOUNDDB - GOAL_TARGET - GOAL_TARGET_GROUP - GOAL_TEMPLATE - GSC_PROPERTY - HUB - IMPORT - INVOICE - KEYWORD - KNOWLEDGE_ARTICLE - LANDING_PAGE - LEAD - LINE_ITEM - MARKETING_CALENDAR - MARKETING_CAMPAIGN_UTM - MARKETING_EMAIL - MARKETING_EVENT - MARKETING_EVENT_ATTENDANCE - MARKETING_SMS - MEDIA_BRIDGE - MEETING_EVENT - MIC - NOTE - OBJECT_LIST - ORDER - OWNER - PARTNER_ACCOUNT - PARTNER_CLIENT - PARTNER_CLIENT_REVENUE - PARTNER_SERVICE - PAYMENT_LINK - PAYMENT_SCHEDULE - PAYMENT_SCHEDULE_INSTALLMENT - PERMISSIONS_TESTING - PLAYBOOK - PLAYBOOK_QUESTION - PLAYBOOK_SUBMISSION - PLAYBOOK_SUBMISSION_ANSWER - PLAYLIST - PLAYLIST_FOLDER - PODCAST_EPISODE - PORTAL - PORTAL_OBJECT_SYNC_MESSAGE - POSTAL_MAIL - PRIVACY_SCANNER_COOKIE - PRODUCT - PRODUCT_OR_FOLDER - PROPERTY_INFO - PROSPECTING_AGENT_CONTACT_ASSIGNMENT - PUBLISHING_TASK - QUARANTINED_SUBMISSION - QUOTA - QUOTE - QUOTE_FIELD - QUOTE_MODULE - QUOTE_MODULE_FIELD - QUOTE_TEMPLATE - RESTORABLE_CRM_OBJECT - ROSTER - ROSTER_MEMBER - SALES_DOCUMENT - SALES_TASK - SALES_WORKLOAD - SALESFORCE_SYNC_ERROR - SCHEDULING_PAGE - SCHEMAS_BACKEND_TEST - SCORE_CONFIGURATION - SEQUENCE - SEQUENCE_ENROLLMENT - SEQUENCE_STEP - SEQUENCE_STEP_ENROLLMENT - SERVICE - SITE_PAGE - SNIPPET - SOCIAL_BROADCAST - SOCIAL_CHANNEL - SOCIAL_POST - SOCIAL_PROFILE - SOX_PROTECTED_DUMMY_TYPE - SOX_PROTECTED_TEST_TYPE - SUBMISSION_TAG - SUBSCRIPTION - TASK - TASK_TEMPLATE - TAX - TEMPLATE - TICKET - UNKNOWN - UNSUBSCRIBE - USER - VIEW - VIEW_BLOCK - WEB_INTERACTIVE searchTextAnalysisMode: type: string description: A string indicating the mode of text analysis for search purposes. enum: - NONE - NOT_ANALYZED_TEXT searchableInGlobalSearch: type: boolean description: A boolean indicating if the property is searchable in global search. sensitiveDataCategories: type: array description: >- An array of strings representing the categories of sensitive data associated with this property. items: type: string showCurrencySymbol: type: boolean description: >- A boolean indicating if the currency symbol should be displayed for the property. textDisplayHint: type: string description: >- A string providing a hint for displaying text, with options like 'unformatted_single_line', 'multi_line', 'email', 'phone_number', 'domain_name', 'ip_address', 'physical_address', or 'postal_code'. enum: - domain_name - email - ip_address - multi_line - phone_number - physical_address - postal_code - unformatted_single_line type: type: string description: >- A string indicating the type of the property, such as 'bool', 'date', 'datetime', 'enumeration', 'number', 'phone_number', or 'string'. enum: - bool - currency_number - date - datetime - enumeration - json - number - object_coordinates - phone_number - string - time_range updatedAt: type: integer description: >- A string representing the date and time when the property was last updated, in ISO 8601 format. format: int64 description: A HubSpot property StandardError: required: - category - context - errors - links - message - status type: object properties: category: type: string description: >- A broad classification of the error, indicating the type of issue encountered. context: type: object additionalProperties: type: array items: type: string description: >- A map of additional context or metadata related to the error, which may include specific parameters or values involved in the error. errors: type: array description: >- An array of detailed error messages or codes that provide more granular information about the error. items: $ref: '#/components/schemas/ErrorDetail' id: type: string description: A unique identifier for the error instance. links: type: object additionalProperties: type: string description: >- A collection of URLs or references to related resources or documentation that may help in understanding or resolving the error. message: type: string description: A human-readable message describing the error. status: type: string description: The HTTP status code associated with the error. subCategory: type: object properties: {} description: >- A more specific classification of the error, providing additional context about the issue. description: Ye olde error Error: required: - category - correlationId - message type: object properties: category: type: string description: The error category context: type: object additionalProperties: type: array items: type: string description: Context about the error condition example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- A unique identifier for the request. Include this value with any error reports or support tickets format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: further information about the error items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- A map of link names to associated URIs containing documentation about the error or recommended remediation steps message: type: string description: >- A human readable message describing the error along with remediation steps where appropriate example: An error occurred subCategory: type: string description: >- A specific category that contains more specific detail about the error 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 ObjectTypeIdProto: required: - innerId - metaTypeId type: object properties: innerId: type: integer description: >- A property likely representing an internal identifier for the object type. The data type is not specified in the provided spec. format: int32 metaTypeId: type: integer description: >- A property that probably refers to a meta type identifier associated with the object type. The data type is not specified in the provided spec. format: int32 Option: required: - description - displayOrder - doubleData - hidden - label - readOnly - value type: object properties: description: type: string description: A string providing additional information about the option. displayOrder: type: integer description: >- An integer indicating the order in which the option should be displayed relative to other options. format: int32 doubleData: type: number description: >- A number that may provide additional data associated with the option. hidden: type: boolean description: A boolean indicating whether the option is hidden from display. label: type: string description: A string representing the display name of the option. readOnly: type: boolean description: >- A boolean specifying if the option is read-only and cannot be modified. value: type: string description: A string representing the unique value associated with the option. description: A HubSpot property option 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 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 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. 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: developers-read: '' developers-write: '' media_bridge.write: '' ````