---
title: "Delete event subscription"
method: DELETE
path: "/event-subscriptions/{subscriptionId}"
tags: ["eventSubscriptions"]
---

# Delete event subscription

`DELETE /event-subscriptions/{subscriptionId}`

Use this method to delete an event subscription.  

> **Important:** After you delete an event subscription, you can’t recover it. You won't receive event notifications from the event subscription.  

To delete an event subscription, you need its subscriptionId. Our gateway returned the subscriptionId in the response of the [Create Event Subscription](https://docs.payroc.com/api/schema/notifications/event-subscriptions/create) method.  

If you want to stop receiving event notifications but don't want to delete the event subscription, use our [Update Event Subscription](https://docs.payroc.com/api/schema/notifications/event-subscriptions/update) method to deactivate it.

## Path parameters

- `subscriptionId` integer, required

## Headers

- `Authorization` string, required

## Response `204`

Successful request. We deleted the event subscription.

- object

## Other responses

- `400` — Invalid request
- `401` — Identity could not be verified
- `404` — Resource not found
- `500` — An error has occured

---

[API](https://skmtc.dev/payroc/apis/schema.md) · [All operations](https://skmtc.dev/payroc/apis/schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/payroc/schema/revisions/1d9d3e305945/schema)