Webhooks

Delete a webhook endpoint

DEL/v2/accounts/{accountId}/webhooks/{webhookId}Try it

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.

Request

Authorization

Bearer token

Send your API key in the Authorization header: Authorization: Bearer sk_test_…. A sk_test_ key creates and sees test orders only. Keys and test mode.

Path parameters
  • accountIdstringrequired
    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.
  • webhookIdstring (uuid)required
    The endpoint's id

Responses

200The deleted endpoint
401Unauthorized, authentication required, or an OAuth access token unknown, expired or revoked (INVALID_TOKEN)

Type: Error

403The 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)

Type: Error

404No endpoint of this id for the account and mode (WEBHOOK_NOT_FOUND)

Type: Error

500Internal server error

Type: Error

Request
curl -X DELETE "https://api.printags.com/v2/accounts/@me/webhooks/{webhookId}" \
  -H "Authorization: Bearer $PRINTAGS_API_KEY"
Response 200
{
  "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"
      }
    ]
  }
}