delete
https://partner.gupshup.io/partner/app//subscription/
This API endpoint enables partners to delete a specific webhook subscription by its unique subscription ID. Unlike the general delete subscription endpoint that removes all subscriptions for an app, this endpoint provides granular control to remove individual subscriptions when multiple webhook configurations exist. This is particularly useful for managing multi-environment setups, removing deprecated webhooks, or cleaning up test subscriptions.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Request Parameters
| Key | Value | Description | Data Types | Require/Optional | Constraints |
|---|---|---|---|---|---|
| Authorization | {{PARTNER_APP_TOKEN}} | Partner app access token issued post partner login | String | Required | Should be a valid Partner app access token belonging to the passed appId |
| appId | {{App_ID}} | App ID for the app to be deleted | String | Required | Valid app ID |
| SUBSCRIPTION_ID | 2xxxx | Subscription ID | String | Required | Id of the subscription to be deleted |
Sample Request
curl --location --request DELETE 'https://partner.gupshup.io/partner/app/{{APP_ID}}/subscription/{{SUBSCRIPTION_ID}}' \
--header 'Authorization: {{PARTNER_APP_TOKEN}}'Sample Response
Status Codes
| Status Code | Response | Comments |
|---|---|---|
| Success | ||
| 204 | Success when subscriptions are deleted. No content. | |
| Error | ||
| 400 | { "status": "error", "message": "API key is not associated with partner" } | Error with respect to API Key |
| 429 | { "status": "error", "message": "Too Many Requests" } | Rate limit exceeded |