OneTap Webhook Manager icon

OneTap Webhook Manager

Register and manage webhooks with OneTap
Join our community

Actions4

Overview

This node, OneTap Webhook Manager, allows you to manage webhooks with the OneTap API. It supports registering new webhooks, unregistering existing ones, listing all registered webhooks, and updating webhook configurations. This is useful for automating event-driven workflows based on participant check-ins, profile changes, list updates, and other events tracked by OneTap.

Common scenarios:

  • Automatically registering a webhook URL to receive real-time notifications when participants check in or out.
  • Unregistering a webhook when it is no longer needed or before deleting an integration.
  • Listing all current webhooks to audit or monitor active integrations.
  • Updating webhook URLs, subscribed events, or security settings without recreating the webhook.

Practical example:
You could use this node to register a webhook that triggers an n8n workflow whenever a new participant checks in at an event, enabling automated follow-up actions such as sending welcome emails or updating CRM records.

Properties

Name Meaning
Environment Select which OneTap environment to use:
- Production (official API server)
- Staging (development server)
Integration ID The ID of the integration/webhook to unregister or update (required for "Unregister Webhook" and "Update Webhook" operations)

Output

The node outputs JSON objects containing details about the performed operation:

  • For Unregister Webhook operation:
    • success: Boolean indicating if the operation succeeded.
    • operation: The string "unregister".
    • environment: The selected environment (production or staging).
    • integrationId: The ID of the unregistered integration.
    • Additional response data from the OneTap API.

The output is paired with the input item index for traceability.

No binary data output is produced by this node.

Dependencies

  • Requires an API authentication credential for OneTap to authorize requests.
  • The node uses different base URLs depending on the selected environment:
    • Production: https://api-beta.onetapcheckin.com
    • Staging: http://localhost:1337
  • Proper network access to the OneTap API endpoints is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Integration ID when attempting to unregister a webhook will cause errors.
    • Network connectivity problems or incorrect environment selection may lead to failed API calls.
    • Insufficient permissions or invalid API credentials can result in authorization errors.

  • Error messages:

    • Errors include descriptive messages like Failed to unregister webhook with OneTap: <error message>.
    • To resolve, verify the Integration ID, ensure correct environment selection, and confirm valid API credentials.
    • If continuing on failure is enabled, errors are returned in the output JSON instead of stopping execution.

Links and References

Discussion