Bring Visitor Management
to OpenAI Agents SDK

Provide group data as JSON including name, scheduled date, expected attendees, host, and location. Example: { "name": "Campus Tour", "scheduledDate": "2026-04-15", "expectedAttendees": 15, "hostId": "host_123", "locationId": "loc_456" } Create a new group visit (group appointment)

Hosts are employees who can receive and host visitors. You must provide host data as JSON including name, email, department, and optionally phone number and location assignment. Example: { "firstName": "John", "lastName": "Doe", "email": "john@company.com", "department": "Engineering" } Create a new host (employee) in Traction Guest

Provide an array of host objects as JSON. Each host must include firstName, lastName, and email. This is useful for bulk onboarding new employees or importing host lists from HR systems. Example: [{ "firstName": "John", "lastName": "Doe", "email": "john@company.com" }, { "firstName": "Jane", "lastName": "Smith", "email": "jane@company.com" }] Create multiple hosts in a single batch operation

You must provide the location_id and invite data as JSON including visitor name, email, host, and scheduled date/time. Example: { "firstName": "Alice", "lastName": "Johnson", "email": "alice@example.com", "hostId": "host_123", "scheduledDate": "2026-04-10", "scheduledTime": "10:00" } Create a new visitor invite for a location

Provide sign-in data as JSON including visitor information, host, location, and purpose of visit. Example: { "visitorName": "Alice Johnson", "hostId": "host_123", "locationId": "loc_456", "purpose": "Interview" } Create a new visitor sign-in (check-in a visitor on-site)

Provide watchlist data as JSON including name, description, and optionally entries. Example: { "name": "Restricted Visitors", "description": "Individuals not permitted on-site" } Create a new security watchlist

You must provide the group_visit_id. This action cannot be undone. Use this to cancel scheduled group events that are no longer needed. Delete a group visit

You must provide the invite_id. This action cannot be undone. Use this to cancel scheduled visits that are no longer needed. Be careful as this will remove all associated visitor data for that invite. Delete a visitor invite

Use the group_visit_id obtained from list_group_visits to inspect full group visit details. Get detailed information about a specific group visit

Use the invite_id obtained from list_invites to inspect full invite details. Get detailed information about a specific visitor invite

Use the location_id obtained from list_locations to inspect full location details. This is useful for verifying location configuration before creating invites or managing visitors. Get detailed information about a specific location

Use the signin_id obtained from list_signins to inspect full visit details. Get detailed information about a specific visitor sign-in

Use this for compliance reporting, security investigations, and operational auditing. List audit logs for compliance and security tracking

Each group visit includes name, scheduled date, expected attendees, host, and location. Use this to manage tours, training sessions, interviews, and other group events. List all group visits (group appointments) in your organization

Each host includes name, email, department, location assignment, and contact information. Use this to see who is available to host visitors and verify host assignments to locations. List all hosts (employees/hosts) in your Traction Guest organization

Each invite includes visitor name, email, host, scheduled date, location, and status. Use this to see upcoming visitors, manage invite lists, and prepare for expected arrivals. Optionally provide a location_id to filter invites for a specific location. List all visitor invites in your organization

Each location includes name, address, timezone, and configuration details. Use this to discover available locations before creating invites, sign-ins, or assigning hosts. List all locations in your Traction Guest organization

Each package includes name, description, included features, and pricing. Use this to understand available visitor management configurations. List packages (visitor management packages/plans) in your organization

Each registration includes visitor information, registration date, and associated event or purpose. Use this to manage pre-registration queues and convert registrations to invites. List visitor registrations in your organization

Each sign-in includes visitor name, host, location, check-in time, check-out time, and purpose of visit. Use this to monitor visitor activity, track who is currently on-site, and review visit history. List all visitor sign-ins (check-ins) in your organization

Watchlists are used to screen visitors against known individuals who should be flagged or denied access. Each watchlist includes name, description, and number of entries. Use this to verify security screening configurations. List all security watchlists in your organization

Common updates include rescheduling, changing expected attendee count, or updating host assignments. You must provide the group_visit_id and the fields to update as JSON. Update an existing group visit

You must provide the invite_id and the fields to update as JSON. Common updates include rescheduling dates, changing hosts, or updating visitor information. Only provide the fields you want to change. Update an existing visitor invite

Common updates include recording check-out times, updating visit purpose, or modifying host assignments. You must provide the signin_id and the fields to update as JSON. Update an existing visitor sign-in record