---
title: "Upsert subscription"
method: POST
path: "/webhooks-journal/subscriptions/2026-09"
tags: ["Basic"]
---

# Upsert subscription

`POST /webhooks-journal/subscriptions/2026-09`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/webhooks-journal/subscriptions/2026-09`
- Auth: none required

Create a new webhook journal subscription for the specified portal. This endpoint allows you to define the actions and object types that the subscription will monitor. It requires a request body with the subscription details.

## Request body

- union
  - object
    - `actions` string[], required: An array of strings specifying the actions that trigger the subscription. Valid actions include 'CREATE', 'UPDATE', 'DELETE', 'MERGE', 'RESTORE', 'ASSOCIATION_ADDED', 'ASSOCIATION_REMOVED', 'SNAPSHOT', 'APP_INSTALL', 'APP_UNINSTALL', 'ADDED_TO_LIST', 'REMOVED_FROM_LIST', and 'GDPR_DELETE'.
    - `objectIds` integer[], required: An array of integers specifying the unique identifiers of the objects involved in the subscription.
    - `objectTypeId` string, required: A string representing the unique identifier of the object type for which the subscription is being created or updated.
    - `portalId` integer, required: An integer representing the unique identifier of the HubSpot portal.
    - `properties` string[], required: An array of strings listing the properties of the objects that are relevant to the subscription.
    - `subscriptionType` 'OBJECT', required: A string indicating the type of subscription, which is always 'OBJECT' for this request.
  - object
    - `actions` string[], required: An array of strings specifying the actions that trigger the subscription. Valid actions include 'CREATE', 'UPDATE', 'DELETE', 'MERGE', 'RESTORE', 'ASSOCIATION_ADDED', 'ASSOCIATION_REMOVED', 'SNAPSHOT', 'APP_INSTALL', 'APP_UNINSTALL', 'ADDED_TO_LIST', 'REMOVED_FROM_LIST', and 'GDPR_DELETE'.
    - `associatedObjectTypeIds` string[], required: An array of strings representing the type identifiers of the associated objects in the subscription.
    - `objectIds` integer[], required: An array of integers representing the unique identifiers of the objects involved in the subscription.
    - `objectTypeId` string, required: A string representing the type identifier of the object involved in the subscription.
    - `portalId` integer, required: An integer representing the unique identifier of the HubSpot portal.
    - `subscriptionType` 'ASSOCIATION', required: A string indicating the type of subscription, which is 'ASSOCIATION' for this component.
  - object
    - `eventTypeId` string, required: A string representing the unique identifier for the event type that the subscription is related to.
    - `properties` string[], required: An array of strings specifying the properties associated with the event type that should be included in the subscription.
    - `subscriptionType` 'APP_LIFECYCLE_EVENT', required: A string indicating the type of subscription, which is 'APP_LIFECYCLE_EVENT' by default.
  - object
    - `actions` string[], required: An array of strings specifying the actions that trigger the subscription. Valid actions include 'CREATE', 'UPDATE', 'DELETE', 'MERGE', 'RESTORE', 'ASSOCIATION_ADDED', 'ASSOCIATION_REMOVED', 'SNAPSHOT', 'APP_INSTALL', 'APP_UNINSTALL', 'ADDED_TO_LIST', 'REMOVED_FROM_LIST', and 'GDPR_DELETE'.
    - `listIds` integer[], required: An array of integers representing the unique identifiers of the lists involved in the subscription.
    - `objectIds` integer[], required: An array of integers representing the unique identifiers of the objects involved in the subscription.
    - `portalId` integer, required: An integer representing the unique identifier of the portal in which the subscription is being managed.
    - `subscriptionType` 'LIST_MEMBERSHIP', required: A string indicating the type of subscription. The default and only valid value is 'LIST_MEMBERSHIP'.
  - object
    - `actions` string[], required: An array of actions that can trigger the subscription, such as 'CREATE', 'UPDATE', 'DELETE', and 'GDPR_DELETE'.
    - `objectTypeId` string, required: A string representing the unique identifier for the object type associated with the subscription.
    - `portalId` integer, required: The unique identifier for the HubSpot portal, represented as a 64-bit integer.
    - `subscriptionType` 'GDPR_PRIVACY_DELETION', required: The type of subscription, which is fixed as 'GDPR_PRIVACY_DELETION'.

## Response `200`

successful operation

- SubscriptionResponse
  - `actionOverrides` object: An object containing overrides for actions, where each key is an action and the value is an ActionOverrideRequest object.
  - `actions` string[], required: An array of actions associated with the subscription. Valid actions include 'CREATE', 'UPDATE', 'DELETE', 'MERGE', 'RESTORE', 'ASSOCIATION_ADDED', 'ASSOCIATION_REMOVED', 'SNAPSHOT', 'APP_INSTALL', 'APP_UNINSTALL', 'ADDED_TO_LIST', 'REMOVED_FROM_LIST', and 'GDPR_DELETE'.
  - `appId` integer, required: The unique identifier for the app associated with the subscription, represented as an integer.
  - `associatedObjectTypeIds` string[]: An array of strings representing the IDs of associated object types.
  - `createdAt` string, date-time, required: The date and time when the subscription was created, in ISO 8601 format.
  - `createdBy` integer: The unique identifier of the user who created the subscription, represented as an integer.
  - `deletedAt` string, date-time: The date and time when the subscription was deleted, in ISO 8601 format, if applicable.
  - `id` integer, required: The unique identifier for the subscription, represented as an integer.
  - `listIds` integer[]: An array of integers representing the IDs of lists associated with the subscription.
  - `objectIds` integer[]: An array of integers representing the IDs of objects associated with the subscription.
  - `objectTypeId` string, required: The identifier for the type of object associated with the subscription, represented as a string.
  - `portalId` integer: The unique identifier for the portal associated with the subscription, represented as an integer.
  - `properties` string[]: An array of strings representing the properties associated with the subscription.
  - `subscriptionType` 'APP_LIFECYCLE_EVENT' | 'ASSOCIATION' | 'EVENT' | 'GDPR_PRIVACY_DELETION' | 'LIST_MEMBERSHIP' | 'OBJECT', required: The type of subscription, indicating the nature of events it pertains to. Valid values include 'OBJECT', 'ASSOCIATION', 'EVENT', 'APP_LIFECYCLE_EVENT', 'LIST_MEMBERSHIP', and 'GDPR_PRIVACY_DELETION'.
  - `updatedAt` string, date-time, required: The date and time when the subscription was last updated, in ISO 8601 format.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-21** (2026-09) `8c531f8e2735`: 1 info
  - the endpoint scheme security `oauth2` was removed from the API

[Operation history](https://skmtc.dev/hubspot/apis/webhooks-journal-webhooks-journal/changes/webhooks-journal/subscriptions/2026-09/post.md)

---

[API](https://skmtc.dev/hubspot/apis/webhooks-journal-webhooks-journal.md) - [All operations](https://skmtc.dev/hubspot/apis/webhooks-journal-webhooks-journal/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/webhooks-journal-webhooks-journal/revisions/719b973f98aa?raw)