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

# Upsert subscription

`POST /webhooks-journal/subscriptions/2027-03-beta`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/webhooks-journal/subscriptions/2027-03-beta`
- 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
    - `includeSensitivePropertiesChanged` boolean
    - `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

- SubscriptionResponseMarch2027
  - `actionOverrides` object
  - `actions` string[], required
  - `appId` integer, required
  - `associatedObjectTypeIds` string[]
  - `createdAt` string, date-time, required
  - `createdBy` integer
  - `deletedAt` string, date-time
  - `id` integer, required
  - `includeSensitivePropertiesChanged` boolean
  - `listIds` integer[]
  - `objectIds` integer[]
  - `objectTypeId` string, required
  - `portalId` integer
  - `properties` string[]
  - `subscriptionType` 'APP_LIFECYCLE_EVENT' | 'ASSOCIATION' | 'EVENT' | 'GDPR_PRIVACY_DELETION' | 'LIST_MEMBERSHIP' | 'OBJECT', required
  - `updatedAt` string, date-time, required

## Other responses

- `default`: An error occurred.

## Changes

- **2026-10-27** (2027-03-beta) `52ad3f66d668`: 1 breaking, 2 info
  - removed `#/components/schemas/ObjectSubscriptionUpsertRequest, #/components/schemas/AssociationSubscriptionUpsertRequest, #/components/schemas/AppLifecycleEventSubscriptionUpsertRequest, #/components/schemas/ListMembershipSubscriptionUpsertRequest, #/components/schemas/GdprPrivacyDeletionSubscriptionUpsertRequest` from the request body `oneOf` list
  - added `#/components/schemas/ObjectSubscriptionUpsertRequestMarch2027, #/components/schemas/AssociationSubscriptionUpsertRequestMarch2027, #/components/schemas/AppLifecycleEventSubscriptionUpsertRequestMarch2027, #/components/schemas/ListMembershipSubscriptionUpsertRequestMarch2027, #/components/schemas/GdprPrivacyDeletionSubscriptionUpsertRequestMarch2027` to the request body `oneOf` list
  - added the optional property `includeSensitivePropertiesChanged` to the response with the `200` status
- **2026-09-17** (2027-03-beta) `9a67db8e1ed3`: 1 info
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-08-20** (2027-03-beta) `c606498b96ba`: 1 info
  - api operation id `post-/webhooks-journal/subscriptions/2027-03-beta` removed and replaced with `post-/webhooks-journal/subscriptions/2027-03-beta_/webhooks-journal/subscriptions/2027-03-beta`
- **2026-08-20** (2027-03-beta) `f4cd3decbd22`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/webhooks-journal-webhooks-journal/changes/webhooks-journal/subscriptions/2027-03-beta/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/52ad3f66d668?raw)