Actions36
- List Actions
- Participant Actions
- Passport Actions
- Profile Actions
- Punch Pass Actions
Punch Pass → Create
AI-generatedOverview
This node operation creates a new punch pass for a specified profile in the OneTap system. It is useful for managing loyalty or attendance programs where users need to track a limited number of check-ins or visits. For example, a coffee shop could create a punch pass named 'Coffee Loyalty Card' that starts at a specific date and optionally expires after a certain date, with a limit on the number of check-ins allowed.
Use Case Examples
- Create a punch pass for a customer profile starting immediately with a limit of 10 check-ins.
- Create a punch pass with a custom name and expiration date for a profile to manage event attendance.
Properties
| Name | Meaning |
|---|---|
| Profile ID | The ID of the profile to create the punch pass for, required to associate the pass with a user. |
| Starts At | The start date and time for the punch pass, indicating when it becomes active. |
| Create Fields | Additional optional fields for the punch pass such as name, expiration date, and check-ins limit. |
Output
JSON
json- The created punch pass object returned from the OneTap API, containing details of the new punch pass.
Dependencies
- OneTap API with an API key credential for authentication
Troubleshooting
- Ensure the Profile ID is valid and exists in the OneTap system to avoid errors.
- The 'Starts At' date must be a valid date-time string; invalid formats may cause request failures.
- Check that the 'Check Ins Limit' is a positive integer greater than zero.
- API authentication errors may occur if the API key credential is missing or invalid.
Links
- OneTap API Punch Pass Create Endpoint - Official API documentation for creating punch passes in OneTap.