Overview
This node integrates with the TailURL API to manage URL shortening, webhooks, QR code generation, and analytics. Specifically for the Delete Webhook operation, it allows users to delete an existing webhook endpoint by specifying its ID. This is useful in automation workflows where you need to clean up or remove webhook endpoints that are no longer needed or valid.
Common scenarios include:
- Removing obsolete webhook endpoints after a project ends.
- Managing webhook lifecycle dynamically within automated workflows.
- Ensuring security by deleting unused or compromised webhooks.
Example: You have a webhook listening for URL click events, but after changing your workflow, you want to delete this webhook to avoid unnecessary calls. Using this node’s Delete Webhook operation, you provide the webhook ID, and it removes the webhook from TailURL.
Properties
| Name | Meaning |
|---|---|
| Team Name or ID | (Optional) Select the team under which the webhook exists. Choose from a list or specify an ID via expression. If left empty, defaults to the main team associated with the API key. |
| Webhook ID | The unique identifier of the webhook to delete. This is required to specify which webhook to remove. |
Output
The output JSON contains the response from the TailURL API after attempting to delete the webhook. It typically includes a success flag indicating whether the deletion was successful and may contain error messages if the operation failed.
Example output structure:
{
"success": true,
"message": "Webhook deleted successfully"
}
If the deletion fails, the output will contain an error message explaining the failure.
Dependencies
- Requires an API key credential for the TailURL API configured in n8n.
- The node makes authenticated HTTP requests to
https://tailurl.com/api/webhooks/{webhookId}using the DELETE method. - No additional external dependencies beyond the TailURL API and proper credential setup.
Troubleshooting
Common issues:
- Invalid or missing API credentials can cause authentication failures.
- Providing an incorrect or non-existent webhook ID will result in an error.
- Insufficient permissions on the API key to delete webhooks may cause access denied errors.
Error messages and resolutions:
"Failed to delete webhook: Unauthorized": Check that the API key is valid and has permission to manage webhooks."Failed to delete webhook: Not Found": Verify the webhook ID is correct and exists.- Network or connectivity errors: Ensure n8n server can reach
https://tailurl.com.
To handle errors gracefully, enable the node's "Continue On Fail" option to prevent workflow interruption.
Links and References
- TailURL API Documentation (for detailed API usage)
- n8n Expressions Documentation (for dynamic property values)