A time off represents a scheduled period during which a teammate is out of office in Front. While a time off is active, the teammate's status automatically changes to Out of office and any configured auto-responder begins replying to inbound messages on their behalf. At the end of the period, their status switches back to Available.

The Time Off API endpoints let you read these scheduled periods programmatically — for example, to surface upcoming absences in a workforce-management tool, sync them with an Human Resource Information System (HRIS), or skip unavailable teammates when routing work from an external system.

For an end-user overview of the feature, see Time off in the Front Help Center.

Example Time Off object

{
  "_links": {
    "self": "https://yourCompany.api.frontapp.com/time_off/vcr_1bri",
    "related": {
      "teammate": "https://yourCompany.api.frontapp.com/teammates/tea_1abc"
    }
  },
  "id": "vcr_1bri",
  "name": "Out of office",
  "start_at": 1760486400.0,
  "end_at": 1760486400.0,
  "created_at": 1760486400.0,
  "updated_at": 1760486400.0,
  "auto_responder": {
    "is_enabled": true,
    "channel_ids": ["cha_abc", "cha_def"],
    "is_contacts_only": true,
    "body": "Thanks for reaching out. I'm out of office today and will reply when I'm back."
  }
}