Raw schema
{
"type": "object",
"properties": {
"scheduler_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Scheduler id (connecteam_list_schedulers)."
},
"start_time": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "string"
}
],
"description": "Shift start: Unix seconds or ISO 8601 date-time with zone."
},
"end_time": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "string"
}
],
"description": "Shift end: Unix seconds or ISO 8601 date-time with zone."
},
"title": {
"description": "Shift title (required unless job_id is given).",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"job_id": {
"description": "Job id (connecteam_list_jobs) to attach the shift to.",
"type": "string",
"minLength": 1,
"maxLength": 128
},
"assigned_user_ids": {
"description": "The user id to assign (at most one: the V1 endpoint rejects more); empty for an open shift.",
"maxItems": 1,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"is_open_shift": {
"description": "Create an open shift with one spot that an employee can claim (default false).",
"type": "boolean"
},
"require_admin_approval": {
"description": "Claiming needs admin approval (open shifts only).",
"type": "boolean"
},
"timezone": {
"description": "IANA time zone, e.g. America/New_York (default: the account's time zone).",
"type": "string",
"minLength": 1,
"maxLength": 64
},
"is_published": {
"description": "Publish the shift now (default false = draft).",
"type": "boolean"
},
"notify_users": {
"description": "For a published shift: notify the assigned users (Connecteam default true).",
"type": "boolean"
},
"note": {
"description": "A plain-text note shown on the shift.",
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"task_titles": {
"description": "Shift tasks (checklist items) by title.",
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"color": {
"description": "Shift color from Connecteam's palette; defaults to the job's color (or #4B7AC5).",
"type": "string",
"enum": [
"#4B7AC5",
"#801A1A",
"#AE2121",
"#DC7A7A",
"#B0712E",
"#D4985A",
"#E4B37F",
"#AE8E2D",
"#CBA73A",
"#D9B443",
"#487037",
"#6F9B5C",
"#91B282",
"#365C64",
"#5687B3",
"#7C9BA2",
"#3968BB",
"#85A6DA",
"#225A8C",
"#548CBE",
"#81A8CC",
"#4E3F75",
"#604E8E",
"#8679AA",
"#983D73",
"#A43778",
"#D178AD",
"#6B2E4C",
"#925071",
"#B57D9A",
"#3a3a3a",
"#616161",
"#969696"
]
}
},
"required": [
"scheduler_id",
"start_time",
"end_time"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}