Delete a webhook subscription

Deletes a subscription. Events stop being sent to its URL immediately.

DELETE

https://app.touchsms.com.au/api/v2/webhook-subscriptions/{webhookSubscription}

Authorization

basicAuth
HTTP
required

Path parameters

webhookSubscription
integer
required
Webhook subscription ID.

Returns

204

Subscription deleted.

401

Missing, malformed or invalid API credentials.

JSON

message
string
required

403

The resource exists but does not belong to you, or you lack permission.

JSON

message
string
required

404

The resource does not exist.

JSON

message
string
required

Delete a webhook subscription

curl --request DELETE \
  --url https://app.touchsms.com.au/api/v2/webhook-subscriptions/123 \
  --header 'Authorization: Basic <credentials>'

const url = 'https://app.touchsms.com.au/api/v2/webhook-subscriptions/123';
const options = {method: 'DELETE', headers: {Authorization: 'Basic <credentials>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://app.touchsms.com.au/api/v2/webhook-subscriptions/123"

headers = {"Authorization": "Basic <credentials>"}

response = requests.delete(url, headers=headers)

print(response.text)

Response example

{
  "message": "Unauthenticated."
}

{
  "message": "This action is unauthorized."
}

{
  "message": "Not Found"
}