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.
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 | { | Error with respect to API Key |
429 | { | Rate limit exceeded |
