HubSpot CRM Properties API

openapi: 3.0.1
info:
  title: HubSpot CRM Properties
  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
  x-hubspot-api-use-case: Create a set of custom multi-select properties for storing contract data on
    company records.
  x-hubspot-introduction: Use the properties API to store information in fields on individual contact
    records. You can use this API to manage existing default and custom properties, create new custom
    properties, and more.
servers:
- url: https://api.hubapi.com
tags:
- name: Basic
- name: Batch
paths:
  /crm/properties/2026-09/{objectType}:
    get:
      tags:
      - Basic
      summary: Read all properties
      description: Read all existing properties for the specified object type and HubSpot account.
      operationId: get-/crm/properties/2026-09/{objectType}_/crm/properties/2025-09/{objectType}
      parameters:
      - name: objectType
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: archived
        in: query
        description: Whether to return only results that have been archived.
        required: false
        style: form
        explode: true
        schema:
          type: boolean
          default: false
      - name: dataSensitivity
        in: query
        description: ''
        required: false
        style: form
        explode: true
        schema:
          type: string
          default: non_sensitive
          enum:
          - highly_sensitive
          - non_sensitive
          - sensitive
      - name: locale
        in: query
        description: ''
        required: false
        style: form
        explode: true
        schema:
          type: string
      - name: properties
        in: query
        description: ''
        required: false
        style: form
        explode: true
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CollectionResponsePropertyNoPaging'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.objects.owners.read
      - oauth2:
        - crm.objects.deals.read
      - oauth2:
        - crm.objects.subscriptions.read
      - oauth2:
        - crm.objects.services.read
      - oauth2:
        - crm.objects.tickets.sensitive.read
      - oauth2:
        - crm.objects.listings.write
      - oauth2:
        - crm.objects.custom.read
      - oauth2:
        - crm.schemas.tickets.read
      - oauth2:
        - crm.objects.tasks.read
      - oauth2:
        - crm.objects.custom.sensitive.write.v2
      - oauth2:
        - crm.objects.custom.highly_sensitive.write.v2
      - oauth2:
        - crm.schemas.quotes.read
      - oauth2:
        - crm.objects.companies.read
      - oauth2:
        - crm.objects.tickets.highly_sensitive.read
      - oauth2:
        - crm.objects.companies.sensitive.read.v2
      - oauth2:
        - media_bridge.read
      - oauth2:
        - crm.objects.deals.highly_sensitive.read.v2
      - oauth2:
        - crm.objects.companies.highly_sensitive.read.v2
      - oauth2:
        - crm.objects.contacts.sensitive.write.v2
      - oauth2:
        - crm.objects.calls.read
      - oauth2:
        - crm.objects.meetings.read
      - oauth2:
        - crm.schemas.services.read
      - oauth2:
        - crm.schemas.line_items.read
      - oauth2:
        - crm.schemas.subscriptions.read
      - oauth2:
        - crm.objects.projects.highly_sensitive.write
      - oauth2:
        - crm.schemas.companies.read
      - oauth2:
        - crm.objects.products.write
      - oauth2:
        - crm.objects.feedback_submissions.read
      - oauth2:
        - crm.objects.services.write
      - oauth2:
        - crm.objects.subscriptions.write
      - oauth2:
        - crm.schemas.calls.read
      - oauth2:
        - crm.schemas.meetings.read
      - oauth2:
        - crm.objects.contacts.read
      - oauth2:
        - crm.objects.invoices.read
      - oauth2:
        - crm.schemas.orders.read
      - oauth2:
        - crm.schemas.emails.read
      - oauth2:
        - crm.schemas.deals.read
      - oauth2:
        - crm.objects.deals.write
      - oauth2:
        - e-commerce
      - oauth2:
        - crm.schemas.notes.read
      - oauth2:
        - crm.objects.companies.sensitive.write.v2
      - oauth2:
        - crm.objects.projects.read
      - oauth2:
        - crm.objects.custom.highly_sensitive.read.v2
      - oauth2:
        - crm.objects.goals.write
      - oauth2:
        - crm.objects.line_items.write
      - oauth2:
        - crm.objects.contacts.write
      - oauth2:
        - crm.objects.goals.read
      - oauth2:
        - crm.objects.line_items.read
      - oauth2:
        - crm.objects.deals.sensitive.read.v2
      - oauth2:
        - crm.objects.projects.sensitive.write
      - oauth2:
        - crm.objects.quotes.write
      - oauth2:
        - tickets.highly_sensitive.v2
      - oauth2:
        - crm.schemas.contacts.read
      - oauth2:
        - crm.objects.leads.read
      - oauth2:
        - crm.objects.leads.write
      - oauth2:
        - crm.schemas.tasks.read
      - oauth2:
        - crm.objects.emails.read
      - oauth2:
        - crm.schemas.invoices.read
      - oauth2:
        - crm.objects.quotes.read
      - oauth2:
        - crm.objects.notes.read
      - oauth2:
        - crm.objects.courses.read
      - oauth2:
        - timeline
      - oauth2:
        - crm.objects.marketing_events.read
      - oauth2:
        - crm.pipelines.orders.read
      - oauth2:
        - crm.objects.contacts.sensitive.read.v2
      - oauth2:
        - crm.schemas.projects.read
      - oauth2:
        - crm.objects.orders.read
      - oauth2:
        - crm.objects.companies.write
      - oauth2:
        - automation
      - oauth2:
        - crm.schemas.carts.read
      - oauth2:
        - cpq.quotes.write
      - oauth2:
        - crm.schemas.listings.read
      - oauth2:
        - crm.objects.contacts.highly_sensitive.read.v2
      - oauth2:
        - crm.objects.appointments.sensitive.read.v2
      - oauth2:
        - crm.objects.contacts.highly_sensitive.write.v2
      - oauth2:
        - crm.objects.commercepayments.write
      - oauth2:
        - crm.objects.invoices.write
      - oauth2:
        - crm.objects.custom.sensitive.read.v2
      - oauth2:
        - crm.objects.users.read
      - oauth2:
        - crm.objects.appointments.write
      - oauth2:
        - tickets
      - oauth2:
        - crm.objects.deals.sensitive.write.v2
      - oauth2:
        - cpq.quotes.read
      - oauth2:
        - crm.objects.appointments.sensitive.write.v2
      - oauth2:
        - crm.objects.projects.highly_sensitive.read
      - oauth2:
        - crm.schemas.appointments.read
      - oauth2:
        - tickets.sensitive.v2
      - oauth2:
        - crm.objects.custom.write
      - oauth2:
        - crm.objects.appointments.read
      - oauth2:
        - crm.schemas.courses.read
      - oauth2:
        - crm.objects.deals.highly_sensitive.write.v2
      - oauth2:
        - crm.objects.companies.highly_sensitive.write.v2
      - oauth2:
        - crm.objects.projects.sensitive.read
      - oauth2:
        - crm.objects.marketing_events.write
      - oauth2:
        - crm.objects.projects.write
      - oauth2:
        - crm.schemas.custom.read
      - oauth2:
        - crm.objects.carts.read
      - oauth2:
        - crm.objects.courses.write
      - oauth2:
        - crm.schemas.commercepayments.read
      - oauth2:
        - crm.objects.listings.read
      x-hubspot-user-level-auth:
        internalOnly: false
    post:
      tags:
      - Basic
      summary: Create a property
      description: Create and return a copy of a new property for the specified object type.
      operationId: post-/crm/properties/2026-09/{objectType}_/crm/properties/2025-09/{objectType}
      parameters:
      - name: objectType
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PropertyCreate'
        required: true
      responses:
        '201':
          description: successful operation
          headers:
            Location:
              description: URL of the newly created resource
              style: simple
              explode: false
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Property'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.schemas.quotes.write
      - oauth2:
        - tickets
      - oauth2:
        - crm.schemas.invoices.write
      - oauth2:
        - crm.schemas.orders.write
      - oauth2:
        - crm.schemas.commercepayments.write
      - oauth2:
        - crm.schemas.courses.write
      - oauth2:
        - tickets.sensitive.v2
      - oauth2:
        - e-commerce
      - oauth2:
        - crm.schemas.appointments.write
      - oauth2:
        - crm.schemas.tasks.write
      - oauth2:
        - crm.schemas.contacts.write
      - oauth2:
        - crm.schemas.carts.write
      - oauth2:
        - crm.objects.tickets.sensitive.write
      - oauth2:
        - crm.schemas.companies.write
      - oauth2:
        - crm.schemas.subscriptions.write
      - oauth2:
        - crm.schemas.emails.write
      - oauth2:
        - crm.schemas.custom.write
      - oauth2:
        - crm.schemas.listings.write
      - oauth2:
        - crm.pipelines.orders.write
      - oauth2:
        - crm.objects.users.write
      - oauth2:
        - tickets.highly_sensitive.v2
      - oauth2:
        - crm.schemas.services.write
      - oauth2:
        - crm.objects.orders.write
      - oauth2:
        - crm.schemas.notes.write
      - oauth2:
        - crm.schemas.meetings.write
      - oauth2:
        - crm.schemas.deals.write
      - oauth2:
        - crm.objects.carts.write
      - oauth2:
        - crm.schemas.calls.write
      - oauth2:
        - crm.schemas.tickets.write
      - oauth2:
        - crm.objects.tickets.highly_sensitive.write
      x-hubspot-user-level-auth:
        internalOnly: false
  /crm/properties/2026-09/{objectType}/batch/archive:
    post:
      tags:
      - Batch
      summary: Archive a batch of properties
      description: Archive a provided list of properties. This method will return a 204 No Content response
        on success regardless of the initial state of the property (e.g. active, already archived, non-existent).
      operationId: post-/crm/properties/2026-09/{objectType}/batch/archive_/crm/properties/2025-09/{objectType}/batch/archive
      parameters:
      - name: objectType
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchInputPropertyName'
        required: true
      responses:
        '204':
          description: No content
          content: {}
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.schemas.quotes.write
      - oauth2:
        - tickets
      - oauth2:
        - crm.schemas.invoices.write
      - oauth2:
        - crm.schemas.orders.write
      - oauth2:
        - crm.schemas.commercepayments.write
      - oauth2:
        - crm.schemas.courses.write
      - oauth2:
        - tickets.sensitive.v2
      - oauth2:
        - e-commerce
      - oauth2:
        - crm.schemas.appointments.write
      - oauth2:
        - crm.schemas.tasks.write
      - oauth2:
        - crm.schemas.contacts.write
      - oauth2:
        - crm.schemas.carts.write
      - oauth2:
        - crm.objects.tickets.sensitive.write
      - oauth2:
        - crm.schemas.companies.write
      - oauth2:
        - crm.schemas.subscriptions.write
      - oauth2:
        - crm.schemas.emails.write
      - oauth2:
        - crm.schemas.custom.write
      - oauth2:
        - crm.schemas.listings.write
      - oauth2:
        - crm.pipelines.orders.write
      - oauth2:
        - crm.objects.users.write
      - oauth2:
        - tickets.highly_sensitive.v2
      - oauth2:
        - crm.schemas.services.write
      - oauth2:
        - crm.objects.orders.write
      - oauth2:
        - crm.schemas.notes.write
      - oauth2:
        - crm.schemas.meetings.write
      - oauth2:
        - crm.schemas.deals.write
      - oauth2:
        - crm.objects.carts.write
      - oauth2:
        - crm.schemas.calls.write
      - oauth2:
        - crm.schemas.tickets.write
      - oauth2:
        - crm.objects.tickets.highly_sensitive.write
  /crm/properties/2026-09/{objectType}/batch/create:
    post:
      tags:
      - Batch
      summary: Create a batch of properties
      description: Create a batch of properties using the same rules as when creating an individual property.
      operationId: post-/crm/properties/2026-09/{objectType}/batch/create_/crm/properties/2025-09/{objectType}/batch/create
      parameters:
      - name: objectType
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchInputPropertyCreate'
        required: true
      responses:
        '201':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponseProperty'
        '207':
          description: multiple statuses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponsePropertyWithErrors'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.schemas.quotes.write
      - oauth2:
        - tickets
      - oauth2:
        - crm.schemas.invoices.write
      - oauth2:
        - crm.schemas.orders.write
      - oauth2:
        - crm.schemas.commercepayments.write
      - oauth2:
        - crm.schemas.courses.write
      - oauth2:
        - tickets.sensitive.v2
      - oauth2:
        - e-commerce
      - oauth2:
        - crm.schemas.appointments.write
      - oauth2:
        - crm.schemas.tasks.write
      - oauth2:
        - crm.schemas.contacts.write
      - oauth2:
        - crm.schemas.carts.write
      - oauth2:
        - crm.objects.tickets.sensitive.write
      - oauth2:
        - crm.schemas.companies.write
      - oauth2:
        - crm.schemas.subscriptions.write
      - oauth2:
        - crm.schemas.emails.write
      - oauth2:
        - crm.schemas.custom.write
      - oauth2:
        - crm.schemas.listings.write
      - oauth2:
        - crm.pipelines.orders.write
      - oauth2:
        - crm.objects.users.write
      - oauth2:
        - tickets.highly_sensitive.v2
      - oauth2:
        - crm.schemas.services.write
      - oauth2:
        - crm.objects.orders.write
      - oauth2:
        - crm.schemas.notes.write
      - oauth2:
        - crm.schemas.meetings.write
      - oauth2:
        - crm.schemas.deals.write
      - oauth2:
        - crm.objects.carts.write
      - oauth2:
        - crm.schemas.calls.write
      - oauth2:
        - crm.schemas.tickets.write
      - oauth2:
        - crm.objects.tickets.highly_sensitive.write
      x-hubspot-user-level-auth:
        internalOnly: false
  /crm/properties/2026-09/{objectType}/batch/read:
    post:
      tags:
      - Batch
      summary: Read a batch of properties
      description: Read a provided list of properties.
      operationId: post-/crm/properties/2026-09/{objectType}/batch/read_/crm/properties/2025-09/{objectType}/batch/read
      parameters:
      - name: objectType
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: locale
        in: query
        description: ''
        required: false
        style: form
        explode: true
        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:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.objects.owners.read
      - oauth2:
        - crm.objects.deals.read
      - oauth2:
        - crm.objects.subscriptions.read
      - oauth2:
        - crm.objects.services.read
      - oauth2:
        - crm.objects.tickets.sensitive.read
      - oauth2:
        - crm.objects.listings.write
      - oauth2:
        - crm.objects.custom.read
      - oauth2:
        - crm.schemas.tickets.read
      - oauth2:
        - crm.objects.tasks.read
      - oauth2:
        - crm.objects.custom.sensitive.write.v2
      - oauth2:
        - crm.objects.custom.highly_sensitive.write.v2
      - oauth2:
        - crm.schemas.quotes.read
      - oauth2:
        - crm.objects.companies.read
      - oauth2:
        - crm.objects.tickets.highly_sensitive.read
      - oauth2:
        - crm.objects.companies.sensitive.read.v2
      - oauth2:
        - media_bridge.read
      - oauth2:
        - crm.objects.deals.highly_sensitive.read.v2
      - oauth2:
        - crm.objects.companies.highly_sensitive.read.v2
      - oauth2:
        - crm.objects.contacts.sensitive.write.v2
      - oauth2:
        - crm.objects.calls.read
      - oauth2:
        - crm.objects.meetings.read
      - oauth2:
        - crm.schemas.services.read
      - oauth2:
        - crm.schemas.line_items.read
      - oauth2:
        - crm.schemas.subscriptions.read
      - oauth2:
        - crm.objects.projects.highly_sensitive.write
      - oauth2:
        - crm.schemas.companies.read
      - oauth2:
        - crm.objects.products.write
      - oauth2:
        - crm.objects.feedback_submissions.read
      - oauth2:
        - crm.objects.services.write
      - oauth2:
        - crm.objects.subscriptions.write
      - oauth2:
        - crm.schemas.calls.read
      - oauth2:
        - crm.schemas.meetings.read
      - oauth2:
        - crm.objects.contacts.read
      - oauth2:
        - crm.objects.invoices.read
      - oauth2:
        - crm.schemas.orders.read
      - oauth2:
        - crm.schemas.emails.read
      - oauth2:
        - crm.schemas.deals.read
      - oauth2:
        - crm.objects.deals.write
      - oauth2:
        - e-commerce
      - oauth2:
        - crm.schemas.notes.read
      - oauth2:
        - crm.objects.companies.sensitive.write.v2
      - oauth2:
        - crm.objects.projects.read
      - oauth2:
        - crm.objects.custom.highly_sensitive.read.v2
      - oauth2:
        - crm.objects.goals.write
      - oauth2:
        - crm.objects.line_items.write
      - oauth2:
        - crm.objects.contacts.write
      - oauth2:
        - crm.objects.goals.read
      - oauth2:
        - crm.objects.line_items.read
      - oauth2:
        - crm.objects.deals.sensitive.read.v2
      - oauth2:
        - crm.objects.projects.sensitive.write
      - oauth2:
        - crm.objects.quotes.write
      - oauth2:
        - tickets.highly_sensitive.v2
      - oauth2:
        - crm.schemas.contacts.read
      - oauth2:
        - crm.objects.leads.read
      - oauth2:
        - crm.objects.leads.write
      - oauth2:
        - crm.schemas.tasks.read
      - oauth2:
        - crm.objects.emails.read
      - oauth2:
        - crm.schemas.invoices.read
      - oauth2:
        - crm.objects.quotes.read
      - oauth2:
        - crm.objects.notes.read
      - oauth2:
        - crm.objects.courses.read
      - oauth2:
        - timeline
      - oauth2:
        - crm.objects.marketing_events.read
      - oauth2:
        - crm.pipelines.orders.read
      - oauth2:
        - crm.objects.contacts.sensitive.read.v2
      - oauth2:
        - crm.schemas.projects.read
      - oauth2:
        - crm.objects.orders.read
      - oauth2:
        - crm.objects.companies.write
      - oauth2:
        - automation
      - oauth2:
        - crm.schemas.carts.read
      - oauth2:
        - cpq.quotes.write
      - oauth2:
        - crm.schemas.listings.read
      - oauth2:
        - crm.objects.contacts.highly_sensitive.read.v2
      - oauth2:
        - crm.objects.appointments.sensitive.read.v2
      - oauth2:
        - crm.objects.contacts.highly_sensitive.write.v2
      - oauth2:
        - crm.objects.commercepayments.write
      - oauth2:
        - crm.objects.invoices.write
      - oauth2:
        - crm.objects.custom.sensitive.read.v2
      - oauth2:
        - crm.objects.users.read
      - oauth2:
        - crm.objects.appointments.write
      - oauth2:
        - tickets
      - oauth2:
        - crm.objects.deals.sensitive.write.v2
      - oauth2:
        - cpq.quotes.read
      - oauth2:
        - crm.objects.appointments.sensitive.write.v2
      - oauth2:
        - crm.objects.projects.highly_sensitive.read
      - oauth2:
        - crm.schemas.appointments.read
      - oauth2:
        - tickets.sensitive.v2
      - oauth2:
        - crm.objects.custom.write
      - oauth2:
        - crm.objects.appointments.read
      - oauth2:
        - crm.schemas.courses.read
      - oauth2:
        - crm.objects.deals.highly_sensitive.write.v2
      - oauth2:
        - crm.objects.companies.highly_sensitive.write.v2
      - oauth2:
        - crm.objects.projects.sensitive.read
      - oauth2:
        - crm.objects.marketing_events.write
      - oauth2:
        - crm.objects.projects.write
      - oauth2:
        - crm.schemas.custom.read
      - oauth2:
        - crm.objects.carts.read
      - oauth2:
        - crm.objects.courses.write
      - oauth2:
        - crm.schemas.commercepayments.read
      - oauth2:
        - crm.objects.listings.read
      x-hubspot-user-level-auth:
        internalOnly: false
  /crm/properties/2026-09/{objectType}/groups:
    get:
      tags:
      - Basic
      summary: Read all property groups
      description: Read all existing property groups for the specified object type and HubSpot account.
      operationId: get-/crm/properties/2026-09/{objectType}/groups_/crm/properties/2025-09/{objectType}/groups
      parameters:
      - name: objectType
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: locale
        in: query
        description: ''
        required: false
        style: form
        explode: true
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CollectionResponsePropertyGroupNoPaging'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.objects.owners.read
      - oauth2:
        - crm.objects.deals.read
      - oauth2:
        - crm.objects.subscriptions.read
      - oauth2:
        - crm.objects.services.read
      - oauth2:
        - crm.objects.tickets.sensitive.read
      - oauth2:
        - crm.objects.listings.write
      - oauth2:
        - crm.objects.custom.read
      - oauth2:
        - crm.schemas.tickets.read
      - oauth2:
        - crm.objects.tasks.read
      - oauth2:
        - crm.objects.custom.sensitive.write.v2
      - oauth2:
        - crm.objects.custom.highly_sensitive.write.v2
      - oauth2:
        - crm.schemas.quotes.read
      - oauth2:
        - crm.objects.companies.read
      - oauth2:
        - crm.objects.tickets.highly_sensitive.read
      - oauth2:
        - crm.objects.companies.sensitive.read.v2
      - oauth2:
        - media_bridge.read
      - oauth2:
        - crm.objects.deals.highly_sensitive.read.v2
      - oauth2:
        - crm.objects.companies.highly_sensitive.read.v2
      - oauth2:
        - crm.objects.contacts.sensitive.write.v2
      - oauth2:
        - crm.objects.calls.read
      - oauth2:
        - crm.objects.meetings.read
      - oauth2:
        - crm.schemas.services.read
      - oauth2:
        - crm.schemas.line_items.read
      - oauth2:
        - crm.schemas.subscriptions.read
      - oauth2:
        - crm.objects.projects.highly_sensitive.write
      - oauth2:
        - crm.schemas.companies.read
      - oauth2:
        - crm.objects.products.write
      - oauth2:
        - crm.objects.feedback_submissions.read
      - oauth2:
        - crm.objects.services.write
      - oauth2:
        - crm.objects.subscriptions.write
      - oauth2:
        - crm.schemas.calls.read
      - oauth2:
        - crm.schemas.meetings.read
      - oauth2:
        - crm.objects.contacts.read
      - oauth2:
        - crm.objects.invoices.read
      - oauth2:
        - crm.schemas.orders.read
      - oauth2:
        - crm.schemas.emails.read
      - oauth2:
        - crm.schemas.deals.read
      - oauth2:
        - crm.objects.deals.write
      - oauth2:
        - e-commerce
      - oauth2:
        - crm.schemas.notes.read
      - oauth2:
        - crm.objects.companies.sensitive.write.v2
      - oauth2:
        - crm.objects.projects.read
      - oauth2:
        - crm.objects.custom.highly_sensitive.read.v2
      - oauth2:
        - crm.objects.goals.write
      - oauth2:
        - crm.objects.line_items.write
      - oauth2:
        - crm.objects.contacts.write
      - oauth2:
        - crm.objects.goals.read
      - oauth2:
        - crm.objects.line_items.read
      - oauth2:
        - crm.objects.deals.sensitive.read.v2
      - oauth2:
        - crm.objects.projects.sensitive.write
      - oauth2:
        - crm.objects.quotes.write
      - oauth2:
        - tickets.highly_sensitive.v2
      - oauth2:
        - crm.schemas.contacts.read
      - oauth2:
        - crm.objects.leads.read
      - oauth2:
        - crm.objects.leads.write
      - oauth2:
        - crm.schemas.tasks.read
      - oauth2:
        - crm.objects.emails.read
      - oauth2:
        - crm.schemas.invoices.read
      - oauth2:
        - crm.objects.quotes.read
      - oauth2:
        - crm.objects.notes.read
      - oauth2:
        - crm.objects.courses.read
      - oauth2:
        - timeline
      - oauth2:
        - crm.objects.marketing_events.read
      - oauth2:
        - crm.pipelines.orders.read
      - oauth2:
        - crm.objects.contacts.sensitive.read.v2
      - oauth2:
        - crm.schemas.projects.read
      - oauth2:
        - crm.objects.orders.read
      - oauth2:
        - crm.objects.companies.write
      - oauth2:
        - automation
      - oauth2:
        - crm.schemas.carts.read
      - oauth2:
        - cpq.quotes.write
      - oauth2:
        - crm.schemas.listings.read
      - oauth2:
        - crm.objects.contacts.highly_sensitive.read.v2
      - oauth2:
        - crm.objects.appointments.sensitive.read.v2
      - oauth2:
        - crm.objects.contacts.highly_sensitive.write.v2
      - oauth2:
        - crm.objects.commercepayments.write
      - oauth2:
        - crm.objects.invoices.write
      - oauth2:
        - crm.objects.custom.sensitive.read.v2
      - oauth2:
        - crm.objects.users.read
      - oauth2:
        - crm.objects.appointments.write
      - oauth2:
        - tickets
      - oauth2:
        - crm.objects.deals.sensitive.write.v2
      - oauth2:
        - cpq.quotes.read
      - oauth2:
        - crm.objects.appointments.sensitive.write.v2
      - oauth2:
        - crm.objects.projects.highly_sensitive.read
      - oauth2:
        - crm.schemas.appointments.read
      - oauth2:
        - tickets.sensitive.v2
      - oauth2:
        - crm.objects.custom.write
      - oauth2:
        - crm.objects.appointments.read
      - oauth2:
        - crm.schemas.courses.read
      - oauth2:
        - crm.objects.deals.highly_sensitive.write.v2
      - oauth2:
        - crm.objects.companies.highly_sensitive.write.v2
      - oauth2:
        - crm.objects.projects.sensitive.read
      - oauth2:
        - crm.objects.marketing_events.write
      - oauth2:
        - crm.objects.projects.write
      - oauth2:
        - crm.schemas.custom.read
      - oauth2:
        - crm.objects.carts.read
      - oauth2:
        - crm.objects.courses.write
      - oauth2:
        - crm.schemas.commercepayments.read
      - oauth2:
        - crm.objects.listings.read
      x-hubspot-user-level-auth:
        internalOnly: false
    post:
      tags:
      - Basic
      summary: Create a property group
      description: Create and return a copy of a new property group.
      operationId: post-/crm/properties/2026-09/{objectType}/groups_/crm/properties/2025-09/{objectType}/groups
      parameters:
      - name: objectType
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PropertyGroupCreate'
        required: true
      responses:
        '201':
          description: successful operation
          headers:
            Location:
              description: URL of the newly created resource
              style: simple
              explode: false
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PropertyGroup'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - crm.schemas.quotes.write
      - oauth2:
        - tickets
      - oauth2:
        - crm.schemas.invoices.write
      - oauth2:
        - crm.schemas.orders.write
      - oauth2:
        - crm.schemas.commercepayments.write
      - oauth2:
        - crm.schemas.courses.write
      - oauth2:
        - tickets.sensitive.v2
      - oauth2:
        - e-commerce
      - oauth2:
        - crm.schemas.appointments.write
      - oauth2:
        - crm.schemas.tasks.write
      - oauth2:
        - crm.schemas.contacts.write
      - oauth2:
        - crm.schemas.carts.write
      - oauth2:
        - crm.objects.tickets.sensitive.write
      - oauth2:
        - crm.schemas.companies.write
      - oauth2:
        - crm.schemas.subscriptions.write
      - oauth2:
        - crm.schemas.emails.write
      - oauth2:
        - crm.schemas.custom.write
      - oauth2:
        - crm.schemas.listings.write
      - oauth2:
        - crm.pipelines.orders.write
      - oauth2:
        - crm.objects.users.write
      - oauth2:
        - tickets.highly_sensitive.v2
      - oauth2:
        - crm.schemas.services.write
      - oauth2:
        - crm.objects.orders.write
      - oauth2:
        - crm.schemas.notes.write
      - oauth2:
        - crm.schemas.meetings.write
      - oauth2:
        - crm.schemas.deals.write
      - oauth2:
        - crm.objects.carts.write
      - oauth2:
        - crm.schemas.calls.write
      - oauth2:
        - crm.schemas.tickets.write
      - oauth2:
        - crm.objects.tickets.highly_sensitive.write
      x-hubspot-user-level-auth:
        internalOnly: false
  /crm/properties/2026-09/{objectType}/groups/{groupName}:
    get:
      tags:
      - Basic
      summary: Read a property group
      description: Read a property group identified by {groupName}.
      operationId: get-/crm/properties/2026-09/{objectTy

# --- truncated at 32 KB (86 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/openapi/hubspot-crm-properties-api-openapi.yml