> ## 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.

# 2026-09-beta Pipelines API

> Create, read, update, and delete object pipelines.

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 <div>
      <div className="text-sm mb-2">{description}</div>
      <div>
        {sortedScopes.map((scope, index) => <div key={index}>
            <code>
              <span className="text-xs">{scope}</span>
            </code>
          </div>)}
      </div>
    </div>;
};

<Accordion title="Scope requirements">
  <ScopesList
    scopes={[
  'automation',
  'crm.objects.appointments.read',
  'crm.objects.appointments.sensitive.read.v2',
  'crm.objects.appointments.sensitive.write.v2',
  'crm.objects.appointments.write',
  'crm.objects.carts.read',
  'crm.objects.carts.write',
  'crm.objects.commercepayments.write',
  'crm.objects.companies.highly_sensitive.read.v2',
  'crm.objects.companies.highly_sensitive.write.v2',
  'crm.objects.companies.read',
  'crm.objects.companies.sensitive.read.v2',
  'crm.objects.companies.sensitive.write.v2',
  'crm.objects.companies.write',
  'crm.objects.contacts.highly_sensitive.read.v2',
  'crm.objects.contacts.highly_sensitive.write.v2',
  'crm.objects.contacts.read',
  'crm.objects.contacts.sensitive.read.v2',
  'crm.objects.contacts.sensitive.write.v2',
  'crm.objects.contacts.write',
  'crm.objects.courses.read',
  'crm.objects.courses.write',
  'crm.objects.custom.highly_sensitive.read.v2',
  'crm.objects.custom.highly_sensitive.write.v2',
  'crm.objects.custom.read',
  'crm.objects.custom.sensitive.read.v2',
  'crm.objects.custom.sensitive.write.v2',
  'crm.objects.custom.write',
  'crm.objects.deals.highly_sensitive.read.v2',
  'crm.objects.deals.highly_sensitive.write.v2',
  'crm.objects.deals.read',
  'crm.objects.deals.sensitive.read.v2',
  'crm.objects.deals.sensitive.write.v2',
  'crm.objects.deals.write',
  'crm.objects.feedback_submissions.read',
  'crm.objects.goals.read',
  'crm.objects.goals.write',
  'crm.objects.invoices.read',
  'crm.objects.invoices.write',
  'crm.objects.leads.read',
  'crm.objects.leads.write',
  'crm.objects.line_items.read',
  'crm.objects.line_items.write',
  'crm.objects.listings.read',
  'crm.objects.listings.write',
  'crm.objects.marketing_events.read',
  'crm.objects.marketing_events.write',
  'crm.objects.orders.read',
  'crm.objects.orders.write',
  'crm.objects.owners.read',
  'crm.objects.products.write',
  'crm.objects.quotes.read',
  'crm.objects.quotes.write',
  'crm.objects.services.read',
  'crm.objects.services.write',
  'crm.objects.subscriptions.read',
  'crm.objects.subscriptions.write',
  'crm.objects.users.read',
  'crm.objects.users.write',
  'crm.pipelines.orders.read',
  'crm.pipelines.orders.write',
  'crm.schemas.appointments.read',
  'crm.schemas.appointments.write',
  'crm.schemas.carts.read',
  'crm.schemas.carts.write',
  'crm.schemas.commercepayments.read',
  'crm.schemas.commercepayments.write',
  'crm.schemas.companies.read',
  'crm.schemas.companies.write',
  'crm.schemas.contacts.read',
  'crm.schemas.contacts.write',
  'crm.schemas.courses.read',
  'crm.schemas.courses.write',
  'crm.schemas.custom.read',
  'crm.schemas.deals.read',
  'crm.schemas.deals.write',
  'crm.schemas.invoices.read',
  'crm.schemas.invoices.write',
  'crm.schemas.line_items.read',
  'crm.schemas.listings.read',
  'crm.schemas.listings.write',
  'crm.schemas.orders.read',
  'crm.schemas.orders.write',
  'crm.schemas.quotes.read',
  'crm.schemas.services.read',
  'crm.schemas.services.write',
  'crm.schemas.subscriptions.read',
  'crm.schemas.subscriptions.write',
  'e-commerce',
  'media_bridge.read',
  'tickets',
  'tickets.highly_sensitive.v2',
  'tickets.sensitive.v2',
  'timeline'
]}
  />
</Accordion>

Use the Pipelines API to create and manage [object pipelines](https://knowledge.hubspot.com/object-settings/set-up-and-customize-pipelines).

## What’s new in 2026-09-beta

In `2026-09-beta` and future versions of the Pipelines API, HubSpot will validate references before deleting a pipeline or pipeline stage. If a pipeline or stage is in use (e.g., the pipeline has records, or is referenced by a workflow), the delete request will be blocked and return a validation error.

To validate, in requests to the following endpoints, the `validateDealStageUsagesBeforeDelete` (deal pipelines) or `validateReferencesBeforeDelete` (all other object pipelines) field defaults to `true`.

* `DELETE` `/crm/pipelines/2026-09-beta/{objectTypeId}/{pipelineId}`
* `DELETE` `/crm/pipelines/2026-09-beta/{objectTypeId}/{pipelineId}/stages/{stageId}`
* `PATCH` `/crm/pipelines/2026-09-beta/{objectTypeId}/{pipelineId}`
* `PUT` `/crm/pipelines/2026-09-beta/{objectTypeId}/{pipelineId}`

## Bypass reference validation checks

To bypass a validation check (i.e., allow a pipeline or stage to be deleted regardless of references), set the `validateDealStageUsagesBeforeDelete` (deal pipelines) or `validateReferencesBeforeDelete` (all other object pipelines) field to `false` in your request.

For example, to skip validation and delete a deal pipeline, include the `validateDealStageUsagesBeforeDelete` in your request: `/crm/pipelines/2026-09-beta/0-3/sales_pipeline?validateDealStageUsagesBeforeDelete=false`

Before migrating to `/2026-09-beta/`, review integration logic that deletes pipelines or pipeline stages.

* If deletes are expected to succeed even when a pipeline or stage is in use, update the requests to pass `false` to the validation query parameters.
* If deletes should not succeed when pipelines or stages are in use, no changes are needed. Users will need to remove references to the pipeline or stages before retrying the delete request.