Schedules

Schedules in Zoho Shifts can be used to manage separate schedules for your multiple business locations, teams, departments or groups.

End Points

GET

/settings/schedules

POST

/settings/schedules

PUT

/settings/schedules/{schedule_id}

DELETE

/settings/schedules/{schedule_id}

Get all schedules

List all schedules in an organization.

Required OAuth Scope: ZohoShifts.settings.READ

$ curl https://shifts.zoho.com/api/v1/{org_id}/settings/schedules
-H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"

{
    "schedules": [
        {
            "id": "714000000002029",
            "name": "Midtown",
            "timezone": "America/Los_Angeles",
            "address": "4141 Hacienda Drive, Pleasanton, CA 94588, USA",
            "latitude": "37.68592076576507",
            "longitude": "-121.89379414320189"
        }
    ]
}

Create a schedule

Required OAuth Scope: ZohoShifts.settings.CREATE

Arguments

name

string

(Required)

address

string

latitude

string

longitude

string

$ curl https://shifts.zoho.com/api/v1/{org_id}/settings/schedules
-X POST
-H "Content-Type: application/json;charset=UTF-8"
-H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"
-d '{"field":"value","field":"value"}'

{
    "name": "Midtown",
    "address": "4141 Hacienda Drive, Pleasanton, CA 94588, USA",
    "latitude": "37.68592076576507",
    "longitude": "-121.89379414320189"
}

{
    "id": "714000000002029",
    "name": "Midtown",
    "timezone": "America/Los_Angeles",
    "address": "4141 Hacienda Drive, Pleasanton, CA 94588, USA",
    "latitude": "37.68592076576507",
    "longitude": "-121.89379414320189"
}

Update a schedule

Required OAuth Scope: ZohoShifts.settings.UPDATE

Arguments

name

string

timezone

string

address

string

latitude

string

longitude

string

$ curl https://shifts.zoho.com/api/v1/{org_id}/settings/schedules/{schedule_id}
-X PUT
-H "Content-Type: application/json;charset=UTF-8"
-H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"
-d '{"field":"value","field":"value"}'

{
    "name": "Midtown",
    "timezone": "America/Los_Angeles",
    "address": "4141 Hacienda Drive, Pleasanton, CA 94588, USA",
    "latitude": "37.68592076576507",
    "longitude": "-121.89379414320189"
}

{
    "id": "714000000002029",
    "name": "Midtown",
    "timezone": "America/Los_Angeles",
    "address": "4141 Hacienda Drive, Pleasanton, CA 94588, USA",
    "latitude": "37.68592076576507",
    "longitude": "-121.89379414320189"
}

Delete a schedule

Required OAuth Scope: ZohoShifts.settings.DELETE

$ curl https://shifts.zoho.com/api/v1/{org_id}/settings/schedules/{schedule_id}
-X DELETE
-H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"

{
    "message": "Schedule deleted"
}