Webhook Subscriptions

Delete webhook subscription

Changed on

Permanently deletes a webhook subscription. This cannot be undone.

delete/v1/webhook_subscriptions/{id}

Request

  • Base URL
    https://api.augustus.com
  • URL
    https://api.augustus.com/v1/webhook_subscriptions/{id}
  • Auth
    HTTP bearer

Path parameters

idstring uuid required
Example:550e8400-e29b-41d4-a716-446655440009

Unique identifier of the webhook subscription.

Response

The deleted webhook subscription resource

idstring required

Unique identifier of the webhook subscription.

type'webhook_subscription' required

Resource type discriminator.

urlstring required

The HTTPS URL where webhook events are delivered.

eventsstring[] required

Event types this subscription receives.

metadataobject required

Set of up to 50 key-value string pairs you can attach to store structured information, such as correlating this resource with an object in your own system. Keys may be up to 40 characters and values up to 500 characters.

created_atstring date-time required

ISO 8601 UTC timestamp when the subscription was created.

updated_atstring date-time required

ISO 8601 UTC timestamp when the subscription was last updated.

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440009",
  "url": "https://sandbox.example.com/webhooks/augustus",
  "events": [
    "payout.sent"
  ],
  "metadata": {
    "invoice_id": "INV-2026-0042"
  },
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-01-15T10:35:00Z"
}

Changes

  • f7ded6c181abRevision changes
    • info

      endpoint added

  • e5198bf3cf7eRevision changes
    • warning

      added the new account_holder.active enum value to the / response property for the response status

    • warning

      added the new account_holder.closed enum value to the / response property for the response status