Skip to content

Managing guests

Guests are external users who participate in specific tasks or processes without needing a full member account. You can use the API to create, list, retrieve, update, and delete guests. Guest endpoints use the guest’s email address (URL-encoded) as the identifier in the path, not a numeric ID.

All endpoints are scoped to your organization at https://go.tallyfy.com/api/organizations/{org_id}/guests.

Guests > List guests

Tallyfy’s API lets you retrieve a paginated and filterable list of external guest users in your organization through a GET request that supports search by email and optional completion statistics and returns detailed guest profiles including access history and task performance data.

Code Samples > Managing groups

Tallyfy’s Groups API lets you bundle members and guests into reusable groups that can be assigned to tasks and processes through standard create/list/get/update/delete operations scoped to your organization.

Guests > Delete guest

Tallyfy’s DELETE endpoint at /organizations/[org_id]/guests/[guest_email] removes a guest by their URL-encoded email address and detaches them from all tasks and the organization while soft-deleting the record if they have no other org memberships.

Guests > Create guest

Tallyfy’s API lets you add external guests to your organization via a POST request with just an email address (plus optional profile fields like name and company) and it automatically links existing global guests instead of creating duplicates.