OneTap icon

OneTap

Manage visitors, check-ins, and attendance with OneTap
Join our community

Actions35

Overview

This node integrates with the OneTap API to manage various entities such as visitors, check-ins, attendance, profiles, passports, punch passes, participants, and lists. Specifically, for the Passport resource with the Delete operation, it allows users to delete a specific passport (group pass) by its ID.

Common scenarios where this node is beneficial include:

  • Automating the removal of expired or invalid group passes from the OneTap system.
  • Managing event access control by programmatically deleting passes that should no longer be valid.
  • Integrating with workflows that clean up or update visitor/passport data based on external triggers.

Example use case:

  • A workflow that deletes a group pass after an event ends by providing the Passport ID to this node's Delete operation.

Properties

Name Meaning
Passport ID The unique identifier of the passport (group pass) to delete. This is a required string input.

Output

The output of the Delete operation for the Passport resource is a JSON object representing the response from the OneTap API after attempting to delete the specified passport. It typically contains confirmation of deletion or error details if the operation failed.

No binary data output is produced by this operation.

Example output JSON structure might look like:

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

or in case of failure:

{
  "error": "Passport not found"
}

Dependencies

  • Requires an active connection to the OneTap API.
  • Requires an API key credential configured in n8n for authenticating requests to OneTap.
  • The node uses HTTP requests to the OneTap API endpoints under https://api-beta.onetapcheckin.com.

Troubleshooting

  • Common issues:

    • Invalid or missing Passport ID: Ensure the Passport ID provided is correct and exists in the OneTap system.
    • Authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
    • Network or API downtime: Check connectivity and OneTap service status.

  • Error messages:

    • "Failed to execute passports operation from OneTap API: <error message>" indicates an issue during the API call. Review the error message for specifics.
    • If the node returns an error JSON with "error" field, it usually means the passport was not found or could not be deleted due to constraints.

  • Resolution tips:

    • Double-check the Passport ID input.
    • Confirm API credentials and permissions.
    • Enable "Continue On Fail" in the node settings to handle errors gracefully in workflows.

Links and References

Discussion