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

# Upsert subscription

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

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
    - `objectIds` integer[], required
    - `objectTypeId` string, required
    - `portalId` integer, required
    - `properties` string[], required
    - `subscriptionType` 'OBJECT', required
  - object
    - `actions` string[], required
    - `associatedObjectTypeIds` string[], required
    - `objectIds` integer[], required
    - `objectTypeId` string, required
    - `portalId` integer, required
    - `subscriptionType` 'ASSOCIATION', required
  - object
    - `eventTypeId` string, required
    - `properties` string[], required
    - `subscriptionType` 'APP_LIFECYCLE_EVENT', required
  - object
    - `actions` string[], required
    - `listIds` integer[], required
    - `objectIds` integer[], required
    - `portalId` integer, required
    - `subscriptionType` 'LIST_MEMBERSHIP', required
  - object
    - `actions` string[], required
    - `objectTypeId` string, required
    - `portalId` integer, required
    - `subscriptionType` 'GDPR_PRIVACY_DELETION', required

## 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-06-15** (2026-03) `88217f2784d4` — 5 breaking, 50 warning, 2 info
  - the request's body type changed from `object` to no type
  - the `actionOverrides/additionalProperties/associatedObjectTypeIds/items/` response's property type changed from `object` to `string` for status `200`
  - the `actions/items/` response's property type changed from `object` to `string` for status `200`
  - the `associatedObjectTypeIds/items/` response's property type changed from `object` to `string` for status `200`
  - …53 more
- **2026-06-15** (2026-03) `e690d002596a` — 6 breaking, 51 info
  - removed `#/components/schemas/ObjectSubscriptionUpsertRequest, #/components/schemas/AssociationSubscriptionUpsertRequest, #/components/schemas/AppLifecycleEventSubscriptionUpsertRequest, #/components/schemas/ListMembershipSubscriptionUpsertRequest, #/components/schemas/GdprPrivacyDeletionSubscriptionUpsertRequest` from the request body `oneOf` list
  - the request's body type changed from no type to `object`
  - the `actionOverrides/additionalProperties/associatedObjectTypeIds/items/` response's property type changed from `string` to `object` for status `200`
  - the `actions/items/` response's property type changed from `string` to `object` for status `200`
  - …53 more
- …earlier changes not shown

[Full history](https://skmtc.dev/hubspot/apis/webhooks-journal-webhooks-journal/changes/webhooks-journal/subscriptions/2026-03/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-service-production.skmtc.workers.dev/v1/apis/hubspot/webhooks-journal-webhooks-journal/revisions/947e5d024fb4/schema)