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 visitor profiles, check-ins, attendance, and related entities such as passports, punch passes, participants, and lists. Specifically, the "Profile" resource with the "Get Single" operation allows users to retrieve detailed information about a specific visitor profile by its unique ID.

Common scenarios for this node include:

  • Fetching detailed visitor information for event management or attendance tracking.
  • Integrating visitor data into workflows for marketing, notifications, or reporting.
  • Automating retrieval of profile data to synchronize with other systems.

Practical example:

  • You have an event registration system and want to fetch a visitor's profile details when they check in at the venue. Using this node, you provide the Profile ID, and it returns all relevant profile data from OneTap.

Properties

Name Meaning
Profile ID The unique identifier of the profile to retrieve. This is required for the "Get Single" operation on the "Profile" resource.

Output

The output is a JSON object representing the profile data retrieved from the OneTap API. It contains all available fields for the specified profile, such as name, email, phone, address, notes, favorite status, check-in code, custom fields, and potentially more depending on the profile's stored data.

The output structure directly reflects the API response under the json property of each item.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential configured in n8n to authenticate requests to the OneTap API.
  • The node makes HTTP requests to the OneTap API endpoint: https://api-beta.onetapcheckin.com/api/profiles/{profileId}.
  • Proper network access to the OneTap API is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Profile ID will cause the API request to fail.
    • Authentication errors if the API key credential is not set up correctly.
    • Network connectivity issues preventing access to the OneTap API.

  • Error messages:

    • Errors returned from the API are caught and can be displayed with descriptive messages indicating failure to execute the requested operation.
    • If "Continue On Fail" is enabled, errors will be included in the output JSON with an error field; otherwise, execution stops with an error.

  • Resolution tips:

    • Verify that the Profile ID is correct and exists in the OneTap system.
    • Ensure the API key credential is valid and has appropriate permissions.
    • Check network connectivity and firewall settings.

Links and References

Discussion