---
title: "Delete a property from a custom event definition"
method: DELETE
path: "/events/v3/event-definitions/{eventName}/property/{propertyName}"
tags: ["Basic"]
---

# Delete a property from a custom event definition

`DELETE /events/v3/event-definitions/{eventName}/property/{propertyName}`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/events/v3/event-definitions/{eventName}/property/{propertyName}`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `behavioral_events.event_definitions.read_write`

Delete an existing property from a custom event definition.

## Path parameters

- `eventName` string, required
- `propertyName` string, required

## Response `204`

No content

## Other responses

- `default`: An error occurred.

## Changes

- **2026-08-14** (v3) `b12482347df4`: 1 info
  - endpoint added
- **2026-07-13** (v3) `8d341c0a911c`: 1 breaking
  - api path removed without deprecation
- **2026-07-13** (v3) `7afd5ac6fbf1`: 1 info
  - endpoint added
- **2026-07-13** (v3) `ae745d244e14`: 1 breaking
  - api path removed without deprecation
- **2026-05-22** (v3) `9028f1ff9bf9`: 2 info
  - the security scope `behavioral_events.event_definitions.read_write` was added to the endpoint's security scheme `oauth2`
  - the security scope `behavioral-events-external-api` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/events-manage-event-definitions/changes/events/v3/event-definitions/:eventName/property/:propertyName/delete.md)

---

[API](https://skmtc.dev/hubspot/apis/events-manage-event-definitions.md) - [All operations](https://skmtc.dev/hubspot/apis/events-manage-event-definitions/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/events-manage-event-definitions/revisions/49b86c29a335?raw)
