Easyteam Embedded
GuidesAPIWhite-Label UIs
GuidesAPIWhite-Label UIs
  1. Development
  • Getting Started
    • Introduction
    • Why Choose Easyteam Embedded
  • Development
    • Overview
    • Authentication
    • Web Integration
    • Mobile SDK Integration
    • Passing Data
    • Using Identifiers
    • Events
    • Error Handling
  • Going Live
    • Data Security
    • Support
  • Embedded Workforce Management
    • Organizations & Locations
    • Employees
    • Permissions
    • Compliance
  • Embedded Time Tracking
    • Time Clock
    • Timesheets
    • Breaks
    • Geofencing
    • Timezones
  • Embedded Scheduling
    • Overview
    • Availability & Open Shifts
    • Multi-Location Scheduling
    • Publishing Schedules
    • Working with Time Off in Schedules
    • Notifications on Schedule Actions
    • Calendar Sync (Google / Apple Calendar)
  • Embedded Time Off Management
    • Overview
    • Time Off Policies
    • Requests & Approvals
    • Balance Tracking & Accruals
    • Carryover Rules
    • Time Off and Payroll Sync
  • Embedded Notifications
    • Overview
  • Payroll Integrations
    • Embedded Payroll with Salsa
      • What is Embedded Payroll?
      • Time & Attendance in Payroll
      • Money Movement and Compliance
    • External Providers
      • Embedded Payroll Integrations
  • AI-Native Integrations
    • Integrating an MCP Server with Easyteam
  1. Development

Error Handling

Overview#

Easyteam provides structured error responses and recovery mechanisms for both client-side and server-side integrations. Understanding these patterns will help you build resilient and user-friendly applications.

Common Error Types#

Errors can be related to either wrong permissions, wrong usage or other edge cases.
Error CategoryCommon ScenariosRecommended Action
AuthenticationAll actionsRefresh authentication token or have user log in again
GeofencingEmployee unable to perform actions from current location
NetworkComponents show loading state indefinitely
Rate LimitingBulk operations failingAdd delay to your API calls
PermissionManager can't edit employee schedulesVerify user's role and permissions
ConfigurationComponents do not loadAn error with your partner settings, permissions or configuration
PayrollPayroll sync not workingPayroll settings were changed by the user or payroll integration key is invalid

Handling API Response Errors#

When making direct API calls, ensure proper error handling.
đź’ˇ
Need help with error handling? Reach out to our team for guidance.
Modified at 2025-03-22 23:17:23
Previous
Events
Next
Data Security