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

## 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) `83a9e3606e9f`: 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) `6995629a4549`: 1 info
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-08-14** (2027-03-beta) `0d8139833c65`: 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-13** (2027-03-beta) `e418414523e9`: 1 info
  - endpoint added

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

---

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