[beta] createTechnicianShift

Create an open or completed shift. Equivalent retries using registered external IDs return the existing shift; conflicting content or aliases return 409.

Rate limit: 100 requests/min (learn more about rate limits here).

To use this endpoint, select Write Technician Shifts under the Work Orders category when creating or editing an API token. Learn More.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
boolean

Include nonempty shift and technician external-ID maps. Defaults to false.

Body Params

Creates an open or completed shift. Only the documented fields are accepted.

date-time
required

Shift start.

date-time

Shift end, strictly after start.

externalIds
object

External identifiers, with at most 30 pairs.

string

Maintenance-shop Place ID.

string
required

Owning technician's Samsara User ID.

Responses

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json