Tallyfy icon

Tallyfy

Interact with Tallyfy workflow automation platform
Join our community

Actions54

Overview

This node integrates with the Tallyfy workflow automation platform to manage guests within an organization. Specifically, the Guest - Get operation retrieves detailed information about a guest user by their email address.

Typical use cases include:

  • Fetching guest details to verify their status or profile before performing further actions.
  • Automating workflows that require guest data retrieval for notifications, reporting, or access control.
  • Integrating guest information into other systems or processes via n8n.

For example, you might use this node to get a guest's full profile in Tallyfy by providing their email, then use that data to customize communications or update records elsewhere.

Properties

Name Meaning
Email The email address of the guest whose information you want to retrieve. This is a required field and must be a valid email string (e.g., guest@example.com).

Output

The node outputs the guest information as JSON data. The structure corresponds to the guest object returned by the Tallyfy API and typically includes fields such as:

  • Guest email
  • First name
  • Last name
  • Other metadata related to the guest's profile in Tallyfy

The output is provided under the json property of the item. There is no binary data output for this operation.

Example output snippet (simplified):

{
  "email": "guest@example.com",
  "first_name": "John",
  "last_name": "Doe",
  ...
}

Dependencies

  • Requires an API key credential for authenticating with the Tallyfy API.
  • The node uses the base URL https://go.tallyfy.com/api or a custom base URL if configured.
  • Requires the organization ID to scope requests properly.
  • Network connectivity to the Tallyfy API endpoint.

Troubleshooting

  • Common issues:

    • Invalid or missing email parameter will cause the request to fail.
    • Authentication errors if the API key credential is invalid or expired.
    • Network errors if the Tallyfy API is unreachable.
    • If the guest email does not exist in the organization, the API may return a 404 or empty response.

  • Error messages:

    • "Guest not found" or similar indicates the email does not correspond to any guest.
    • Authentication errors suggest checking the API key credential configuration.
    • Rate limiting or server errors from Tallyfy should be retried after some delay.

  • Resolution tips:

    • Ensure the email is correctly formatted and exists in Tallyfy.
    • Verify API credentials and permissions.
    • Check network connectivity and proxy settings if applicable.
    • Use the node’s “Continue on Fail” option to handle errors gracefully in workflows.

Links and References

Discussion