---
title: "Delete a webhook endpoint"
description: "Removes the endpoint: nothing more is delivered to it."
canonical: "https://docs.printags.com/delete-a-webhook-endpoint/"
last_updated: "2026-11-16"
---

# Delete a webhook endpoint

`DELETE /v2/accounts/{accountId}/webhooks/{webhookId}`

Removes the endpoint: nothing more is delivered to it. A key deletes the endpoints of its own account and mode only; an OAuth token, only the endpoints it created itself.

## Authentication

An API key as a Bearer token: `Authorization: Bearer <key>`. A `sk_test_` key creates and sees test orders only. Keys and test mode: [overview](/).

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `accountId` | path | string | yes | Unique identifier of the account, or the alias `@me` for the account authenticated by the token. An API key or an OAuth token acts on its own account only: another account's id is refused with 403 `ACCOUNT_ACCESS_DENIED`. |
| `webhookId` | path | string (uuid) | yes | The endpoint's `id` |

## Responses

| Status | Description |
| --- | --- |
| 200 | The deleted endpoint |
| 401 | Unauthorized, authentication required, or an OAuth access token unknown, expired or revoked (`INVALID_TOKEN`) |
| 403 | The API key is inactive or revoked (`INACTIVE_API_KEY`), or the path names another account (`ACCOUNT_ACCESS_DENIED`); with an OAuth access token: a token of scope `mcp` (`INSUFFICIENT_SCOPE`), a path naming another account or a person no longer a member of it (`ACCOUNT_ACCESS_DENIED`), a real token on the sandbox host (`SANDBOX_REQUIRES_TEST_KEY`) |
| 404 | No endpoint of this id for the account and mode (`WEBHOOK_NOT_FOUND`) |
| 500 | Internal server error |

### 200 response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | boolean | no |  |
| `webhook` | [Webhook](/schemas/webhook/) | no |  |

```json
{
  "success": true,
  "webhook": {
    "id": "3c0e8f8a-0000-4000-8000-000000000001",
    "endpoint": "https://boutique.example/wp-json/printags/v1/webhook",
    "description": "WooCommerce",
    "webhook_events": [
      {
        "name": "order.shipped"
      }
    ]
  }
}
```

## Example

```bash
curl -X DELETE "https://api.printags.com/v2/accounts/@me/webhooks/{webhookId}" \
  -H "Authorization: Bearer $PRINTAGS_API_KEY"
```
