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

# Delete a subscription

`DELETE /v3/subscriptions/{subscriptionId}`

## Request

- Base URL: `https://gateway.stage.bill.com/connect-events`
- URL: `https://gateway.stage.bill.com/connect-events/v3/subscriptions/{subscriptionId}`
- Auth: none declared

Delete an existing subscription.

## Path parameters

- `subscriptionId` string, required: BILL-generated ID of the subscription

## Headers

- `sessionId` string, nullable: API session ID generated with `/v3/login`
- `devKey` string, nullable: Developer key sent to you by BILL when you create a developer account. Set `sessionId` and `devKey` for organization-level BILL v3 API webhook events.
- `appKey` string, nullable: Application key sent to you by BILL when you create a partner account. Set `sessionId` and `appKey` for partner-level BILL v3 API webhook events.
- `apiToken` string, nullable: Access token for Spend & Expense API authentication. Set `apiToken` for Spend & Expense webhook events.

## Response `200`

deleteSubscription 200 response

---

[API](https://skmtc.dev/bill/apis/connect-events-api.md) - [All operations](https://skmtc.dev/bill/apis/connect-events-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bill/apis/connect-events-api/revisions/397b6f4013bc?raw)