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 and related data. Specifically, the "Profile - Delete Multiple" operation allows users to delete multiple visitor profiles in a single request by specifying their IDs. This is useful for bulk cleanup or management of visitor records.

Common scenarios include:

  • Removing multiple outdated or invalid visitor profiles at once.
  • Automating profile maintenance workflows where many profiles need to be deleted based on external criteria.
  • Integrating with other systems that identify profiles to be removed in bulk.

Example: You have a list of profile IDs from an external system or previous workflow steps and want to delete all those profiles from OneTap in one API call.

Properties

Name Meaning
Profile IDs Comma-separated list of profile IDs to delete. Each ID corresponds to a visitor profile.

Output

The output JSON contains the response from the OneTap API after attempting to delete the specified profiles. It typically includes status information about the deletion operation, such as success confirmation or error details if any profiles could not be deleted.

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 DELETE requests to the OneTap API endpoint /api/profiles with a JSON body containing the array of profile IDs to delete.
  • Proper API permissions are required to perform bulk deletions on profiles.

Troubleshooting

  • Invalid Profile IDs: If any provided profile ID does not exist or is malformed, the API may return an error or partial success. Verify that all IDs are correct and exist in OneTap.
  • Authentication Errors: Ensure the API key credential is valid and has sufficient permissions.
  • Empty Input: Providing an empty string or no profile IDs will cause the operation to fail. Always provide at least one valid profile ID.
  • API Rate Limits: Bulk operations might be subject to rate limits; if you encounter rate limit errors, consider batching deletions into smaller groups.
  • Error Messages: Errors returned from the API will be included in the node's output. Review these messages for specific issues like permission denied or invalid input format.

Links and References

Discussion