HubSpot Webhooks API

openapi: 3.0.1
info:
  title: HubSpot Webhooks
  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
tags:
- name: Advanced
- name: Basic
- name: Batch
paths:
  /app-webhooks/2026-09/{appId}/settings:
    get:
      tags:
      - Basic
      summary: Read webhook settings
      description: Retrieve the webhook settings for the specified app, including the webhook’s target
        URL, throttle configuration, and create/update date.
      operationId: get-/app-webhooks/2026-09/{appId}/settings_getAll
      parameters:
      - name: appId
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SettingsResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - developers-read
      - oauth2:
        - private-apps-read
    put:
      tags:
      - Basic
      summary: Update webhook settings
      description: Update webhook settings for the specified app.
      operationId: put-/app-webhooks/2026-09/{appId}/settings_configure
      parameters:
      - name: appId
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: integer
          format: int32
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SettingsChangeRequest'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SettingsResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - developers-write
      - oauth2:
        - private-apps-write
    delete:
      tags:
      - Basic
      summary: Delete webhook settings
      description: Delete the webhook settings for the specified app. Event subscriptions will not be
        deleted, but will be paused until another webhook is created.
      operationId: delete-/app-webhooks/2026-09/{appId}/settings_clear
      parameters:
      - name: appId
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: integer
          format: int32
      responses:
        '204':
          description: No content
          content: {}
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - developers-write
      - oauth2:
        - private-apps-write
  /app-webhooks/2026-09/{appId}/subscriptions:
    get:
      tags:
      - Basic
      summary: Read event subscriptions
      description: Retrieve event subscriptions for the specified app.
      operationId: get-/app-webhooks/2026-09/{appId}/subscriptions_getAll
      parameters:
      - name: appId
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubscriptionListResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - developers-read
      - oauth2:
        - private-apps-read
    post:
      tags:
      - Basic
      summary: Create an event subscription
      description: Create new event subscription for the specified app.
      operationId: post-/app-webhooks/2026-09/{appId}/subscriptions_create
      parameters:
      - name: appId
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: integer
          format: int32
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubscriptionCreateRequest'
        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/SubscriptionResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - developers-write
      - oauth2:
        - private-apps-write
  /app-webhooks/2026-09/{appId}/subscriptions/batch/update:
    post:
      tags:
      - Batch
      summary: Batch create event subscriptions
      description: Batch create event subscriptions for the specified app.
      operationId: post-/app-webhooks/2026-09/{appId}/subscriptions/batch/update_updateBatch
      parameters:
      - name: appId
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: integer
          format: int32
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchInputSubscriptionBatchUpdateRequest'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponseSubscriptionResponse'
        '207':
          description: multiple statuses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponseSubscriptionResponseWithErrors'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - developers-write
      - oauth2:
        - private-apps-write
  /app-webhooks/2026-09/{appId}/subscriptions/{subscriptionId}:
    get:
      tags:
      - Basic
      summary: Read an event subscription
      description: Retrieve a specific event subscription by ID.
      operationId: get-/app-webhooks/2026-09/{appId}/subscriptions/{subscriptionId}_getById
      parameters:
      - name: appId
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: integer
          format: int32
      - name: subscriptionId
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubscriptionResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - developers-read
      - oauth2:
        - private-apps-read
    delete:
      tags:
      - Basic
      summary: Delete event subscription
      description: Delete an existing event subscription by ID.
      operationId: delete-/app-webhooks/2026-09/{appId}/subscriptions/{subscriptionId}_archive
      parameters:
      - name: appId
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: integer
          format: int32
      - name: subscriptionId
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: integer
          format: int32
      responses:
        '204':
          description: No content
          content: {}
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - developers-write
      - oauth2:
        - private-apps-write
    patch:
      tags:
      - Basic
      summary: Update an event subscription
      description: Update an existing event subscription by ID.
      operationId: patch-/app-webhooks/2026-09/{appId}/subscriptions/{subscriptionId}_update
      parameters:
      - name: appId
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: integer
          format: int32
      - name: subscriptionId
        in: path
        description: ''
        required: true
        style: simple
        explode: false
        schema:
          type: integer
          format: int32
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubscriptionPatchRequest'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubscriptionResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - developers-write
      - oauth2:
        - private-apps-write
  /webhooks-journal/journal-local/2026-09/batch/earliest/{count}:
    get:
      tags:
      - Batch
      summary: Retrieve Batch
      description: Retrieve the earliest batch of webhook journal entries based on the specified count.
        This endpoint is useful for fetching a specific number of the earliest entries in the webhook
        journal for analysis or processing.
      operationId: get-/webhooks-journal/journal-local/2026-09/batch/earliest/{count}_/webhooks-journal/journal-local/2026-03/batch/earliest/{count}
      parameters:
      - name: count
        in: path
        required: true
        style: simple
        explode: false
        schema:
          minimum: 1
          type: integer
          format: int32
      - name: installPortalId
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponseJournalFetchResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-data-access
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/journal-local/2026-09/batch/latest/{count}:
    get:
      tags:
      - Batch
      summary: Retrieve latest batch
      description: Retrieve the latest batch of webhook journal entries. This endpoint is useful for accessing
        the most recent data entries processed by the webhook journal. It requires specifying the number
        of entries to retrieve.
      operationId: get-/webhooks-journal/journal-local/2026-09/batch/latest/{count}_/webhooks-journal/journal-local/2026-03/batch/latest/{count}
      parameters:
      - name: count
        in: path
        required: true
        style: simple
        explode: false
        schema:
          minimum: 1
          type: integer
          format: int32
      - name: installPortalId
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponseJournalFetchResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-data-access
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/journal-local/2026-09/batch/read:
    post:
      tags:
      - Batch
      summary: Batch read
      description: Perform a batch read operation on the webhooks journal. This endpoint allows you to
        read multiple entries from the journal in a single request. It requires a JSON request body specifying
        the inputs to be read. The response includes the results of the batch read operation, and may
        return multiple statuses if there are errors.
      operationId: post-/webhooks-journal/journal-local/2026-09/batch/read_/webhooks-journal/journal-local/2026-03/batch/read
      parameters:
      - name: installPortalId
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchInputString'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponseJournalFetchResponse'
        '207':
          description: multiple statuses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponseJournalFetchResponseWithErrors'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-data-access
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/journal-local/2026-09/batch/{offset}/next/{count}:
    get:
      tags:
      - Batch
      summary: Retrieve batch
      description: Retrieve a batch of webhook journal entries starting from a specified offset. This
        endpoint allows you to fetch a defined number of entries, facilitating the processing of webhook
        data in manageable chunks.
      operationId: get-/webhooks-journal/journal-local/2026-09/batch/{offset}/next/{count}_/webhooks-journal/journal-local/2026-03/batch/{offset}/next/{count}
      parameters:
      - name: count
        in: path
        required: true
        style: simple
        explode: false
        schema:
          minimum: 1
          type: integer
          format: int32
      - name: offset
        in: path
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: installPortalId
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponseJournalFetchResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-data-access
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/journal-local/2026-09/earliest:
    get:
      tags:
      - Basic
      summary: Retrieve earliest
      description: Retrieve the earliest entry from the webhooks journal for the specified portal. This
        endpoint is useful for accessing the oldest records in the journal, which can be helpful for auditing
        or tracking purposes.
      operationId: get-/webhooks-journal/journal-local/2026-09/earliest_/webhooks-journal/journal-local/2026-03/earliest
      parameters:
      - name: installPortalId
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
      responses:
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-data-access
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/journal-local/2026-09/latest:
    get:
      tags:
      - Basic
      summary: Retrieve latest journal
      description: Retrieve the latest entries from the webhooks journal for the specified portal. This
        endpoint is useful for accessing the most recent webhook events that have been logged, allowing
        you to process or analyze them as needed.
      operationId: get-/webhooks-journal/journal-local/2026-09/latest_/webhooks-journal/journal-local/2026-03/latest
      parameters:
      - name: installPortalId
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
      responses:
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-data-access
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/journal-local/2026-09/offset/{offset}/next:
    get:
      tags:
      - Basic
      summary: Retrieve Next Batch
      description: Retrieve the next set of webhook journal entries starting from a specified offset.
        This endpoint is useful for paginating through webhook journal data in a sequential manner, allowing
        you to fetch entries beyond a given point.
      operationId: get-/webhooks-journal/journal-local/2026-09/offset/{offset}/next_/webhooks-journal/journal-local/2026-03/offset/{offset}/next
      parameters:
      - name: offset
        in: path
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: installPortalId
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
      responses:
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-data-access
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/journal-local/2026-09/status/{statusId}:
    get:
      tags:
      - Basic
      summary: Retrieve status
      description: Retrieve the status of a specific webhook journal entry using its unique status ID.
        This endpoint is useful for monitoring the progress or completion of webhook processing tasks.
      operationId: get-/webhooks-journal/journal-local/2026-09/status/{statusId}_/webhooks-journal/journal-local/2026-03/status/{statusId}
      parameters:
      - name: statusId
        in: path
        required: true
        style: simple
        explode: false
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SnapshotStatusResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-snapshot-management
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/journal/2026-09/batch/earliest/{count}:
    get:
      tags:
      - Batch
      summary: Retrieve Batch
      description: Retrieve the earliest batch of webhook journal entries up to the specified count. This
        endpoint is useful for fetching historical webhook data in batches, allowing you to process or
        analyze the earliest entries first.
      operationId: get-/webhooks-journal/journal/2026-09/batch/earliest/{count}_/webhooks-journal/journal/2026-03/batch/earliest/{count}
      parameters:
      - name: count
        in: path
        required: true
        style: simple
        explode: false
        schema:
          minimum: 1
          type: integer
          format: int32
      - name: installPortalId
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponseJournalFetchResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-data-access
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/journal/2026-09/batch/latest/{count}:
    get:
      tags:
      - Batch
      summary: Retrieve latest batch
      description: Retrieve the latest batch of webhook journal entries. This endpoint allows you to specify
        the number of entries to fetch, providing a way to access recent webhook activity within your
        HubSpot account.
      operationId: get-/webhooks-journal/journal/2026-09/batch/latest/{count}_/webhooks-journal/journal/2026-03/batch/latest/{count}
      parameters:
      - name: count
        in: path
        required: true
        style: simple
        explode: false
        schema:
          minimum: 1
          type: integer
          format: int32
      - name: installPortalId
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponseJournalFetchResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-data-access
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/journal/2026-09/batch/read:
    post:
      tags:
      - Batch
      summary: Batch read
      description: Perform a batch read operation on the webhooks journal for the specified date. This
        endpoint allows you to retrieve multiple entries from the webhooks journal in a single request,
        which can be useful for processing large amounts of data efficiently.
      operationId: post-/webhooks-journal/journal/2026-09/batch/read_/webhooks-journal/journal/2026-03/batch/read
      parameters:
      - name: installPortalId
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchInputString'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponseJournalFetchResponse'
        '207':
          description: multiple statuses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponseJournalFetchResponseWithErrors'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-data-access
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/journal/2026-09/batch/{offset}/next/{count}:
    get:
      tags:
      - Batch
      summary: Fetch Batch Entries
      description: Retrieve a batch of webhook journal entries starting from a specified offset. This
        endpoint allows you to fetch a specified number of entries, making it useful for paginating through
        large sets of webhook journal data.
      operationId: get-/webhooks-journal/journal/2026-09/batch/{offset}/next/{count}_/webhooks-journal/journal/2026-03/batch/{offset}/next/{count}
      parameters:
      - name: count
        in: path
        required: true
        style: simple
        explode: false
        schema:
          minimum: 1
          type: integer
          format: int32
      - name: offset
        in: path
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: installPortalId
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResponseJournalFetchResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-data-access
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/journal/2026-09/earliest:
    get:
      tags:
      - Basic
      summary: Retrieve earliest
      description: Retrieve the earliest entry from the webhooks journal for the specified version. This
        endpoint is useful for accessing the oldest records available in the journal, which can be helpful
        for auditing or historical data analysis.
      operationId: get-/webhooks-journal/journal/2026-09/earliest_/webhooks-journal/journal/2026-03/earliest
      parameters:
      - name: installPortalId
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
      responses:
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-data-access
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/journal/2026-09/latest:
    get:
      tags:
      - Basic
      summary: Retrieve latest journal
      description: Retrieve the latest entries from the webhooks journal for the specified portal. This
        endpoint is useful for accessing the most recent webhook events processed by your HubSpot account.
        It allows you to filter the results by the portal ID to ensure you are retrieving data relevant
        to a specific installation.
      operationId: get-/webhooks-journal/journal/2026-09/latest_/webhooks-journal/journal/2026-03/latest
      parameters:
      - name: installPortalId
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
      responses:
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-data-access
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/journal/2026-09/offset/{offset}/next:
    get:
      tags:
      - Basic
      summary: Retrieve Next Batch
      description: Retrieve the next batch of webhook journal entries starting from a specified offset.
        This endpoint is useful for paginating through large sets of webhook data, allowing you to continue
        fetching entries from where you last left off.
      operationId: get-/webhooks-journal/journal/2026-09/offset/{offset}/next_/webhooks-journal/journal/2026-03/offset/{offset}/next
      parameters:
      - name: offset
        in: path
        required: true
        style: simple
        explode: false
        schema:
          type: string
      - name: installPortalId
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
      responses:
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-data-access
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/journal/2026-09/status/{statusId}:
    get:
      tags:
      - Basic
      summary: Retrieve status
      description: Retrieve the status of a specific webhook journal snapshot entry using its snapshot
        ID. This endpoint is useful for checking the current state of a webhooks journal snapshot, such
        as whether it is pending, in progress, successful, failed, or expired.
      operationId: get-/webhooks-journal/journal/2026-09/status/{statusId}_/webhooks-journal/journal/2026-03/status/{statusId}
      parameters:
      - name: statusId
        in: path
        required: true
        style: simple
        explode: false
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SnapshotStatusResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-snapshot-management
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/snapshots/2026-09/crm:
    post:
      tags:
      - Advanced
      summary: Create Snapshot
      description: Create a batch of CRM object snapshots for the specified portal. This endpoint allows
        you to capture the state of CRM objects at a specific point in time, which can be useful for auditing
        or historical analysis. The request requires a list of CRM object snapshot requests, each specifying
        the portal ID, object ID, object type ID, and properties to include in the snapshot.
      operationId: post-/webhooks-journal/snapshots/2026-09/crm_/webhooks-journal/snapshots/2026-03/crm
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CrmObjectSnapshotBatchRequest'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CrmObjectSnapshotBatchResponse'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-snapshot-management
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
  /webhooks-journal/subscriptions/2026-09:
    get:
      tags:
      - Basic
      summary: Get Existing Subscriptions
      description: Fetch existing subscriptions for the authenticated app
      operationId: get-/webhooks-journal/subscriptions/2026-09_/webhooks-journal/subscriptions/2026-03
      parameters: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CollectionResponseSubscriptionResponseNoPaging'
        default:
          description: ''
          $ref: '#/components/responses/Error'
      security:
      - oauth2:
        - webhooks-journal-subscription-read
      x-hubspot-rate-limit-exemptions:
      - daily
      - ten-secondly
    post:
      tags:
      - Basic
      summary: Upsert Subscription
      description: 'Create or update an existing subscription by specifying the fields and shapes of what
        events you need to listen to. Full documentation on potential subscription types can be found
        on the overview documentation page. '
      operationId: post-/webhooks-journal/subscriptions/2026-09_/webhooks-journal/subscriptions/2026-03
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubscriptionUpsertRequest'
        required: true
      responses:
        '200':
          

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