OneTapInstall

Overview

This node integrates with the OneTap API to manage participants in events or lists. Specifically, the "Participant Delete" operation allows users to delete a participant by their unique Participant ID, optionally targeting a specific list for removal. This is useful in scenarios where you need to remove attendees or visitors from an event or list, such as canceling registrations or cleaning up outdated participant data.

Practical examples:

• Removing a participant who canceled their attendance.
• Cleaning up participants from a specific list after an event.
• Automating participant management workflows by deleting entries based on external triggers.

Properties

Output

The output is a JSON object representing the response from the OneTap API after attempting to delete the participant. It typically contains confirmation of deletion or relevant status information returned by the API.

Example output structure:

{
  "success": true,
  "message": "Participant deleted successfully"
}

or it may contain error details if the deletion failed.

No binary data output is produced by this operation.

Dependencies

• Requires an active connection to the OneTap API via an API key credential configured in n8n.
• The node uses HTTP requests authenticated against the OneTap service endpoint https://api-beta.onetapcheckin.com.
• Proper API credentials must be set up in n8n to authorize these requests.

Troubleshooting

• Common issues:

  • Invalid or missing Participant ID will cause the API to reject the request.
  • If the optional List ID is provided but does not match the participant's actual list, the deletion might fail or have no effect.
  • Network connectivity problems or incorrect API credentials will result in authentication errors.

• Error messages and resolutions:

  • "Failed to execute participants operation from OneTap API: <error message>": Indicates an issue with the API call; check the Participant ID, List ID, and API credentials.
  • HTTP 401 Unauthorized: Verify that the API key credential is correctly configured and has necessary permissions.
  • HTTP 404 Not Found: The specified Participant ID or List ID does not exist; confirm IDs are correct.
  • Rate limiting or server errors: Retry after some time or check OneTap API status.

Links and References

• OneTap API Documentation (general reference for API endpoints)
• n8n documentation on HTTP Request Authentication for setting up API credentials