Actions32
- Messages Actions
- Channels Actions
- Guilds Actions
- Users Actions
- Webhooks Actions
Webhooks → Delete Webhook With Token
AI-generatedOverview
This node operation allows you to delete a Discord webhook using both its unique ID and an associated token. Webhooks in Discord are used to send automated messages or data updates into channels without requiring a bot user. Deleting a webhook with its token is useful when you want to securely remove a webhook that you have access to via the token, ensuring it can no longer be triggered.
Common scenarios include:
- Cleaning up unused or compromised webhooks.
- Automating webhook lifecycle management in Discord servers.
- Revoking webhook access programmatically as part of security or maintenance workflows.
Example: Automatically deleting a webhook after a certain event or time period to prevent further use.
Properties
| Name | Meaning |
|---|---|
| Webhook ID | The unique identifier of the webhook you want to delete. |
| Webhook Token | The secret token associated with the webhook, required to authenticate the deletion. |
Output
The output JSON contains the response from the Discord API regarding the deletion of the webhook. Typically, this will confirm successful deletion or provide error details if the operation failed.
No binary data is output by this operation.
Dependencies
- Requires an API key credential for the external "N8N Tools API" service which acts as a proxy/validation layer for Discord API calls.
- The node uses the Discord API through this external service; thus, valid credentials and subscription to this service are necessary.
- Proper permissions on the Discord side to delete the specified webhook.
- No additional environment variables are explicitly required beyond the configured credentials.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error about invalid subscription or API key, verify that your API key credential is correct and active.
- Permission Errors: Deleting a webhook requires appropriate permissions. Ensure the webhook ID and token are valid and that the authenticated user has rights to delete it.
- Webhook Not Found: If the webhook ID or token is incorrect or the webhook was already deleted, the operation will fail.
- Network Issues: Connectivity problems with the external API service may cause failures; check network and service status.
- Continue On Fail: If enabled, errors will be returned in the output JSON instead of stopping execution, allowing partial processing of multiple items.