---
updatedAt: 2026-04-21T16:11:36.000Z
agentTools:
  projectIndex: https://apidoc.factorialhr.com/llms.txt
---

# ShiftManagement > Shift > Creates

Subscription_type: `shift_management/shift/create`

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Factorial API",
    "description": "",
    "version": "2026-10-01"
  },
  "webhooks": {
    "Webhooks > ShiftManagement > Shift > Creates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `shift_management/shift/create`",
        "deprecated": false,
        "summary": "ShiftManagement > Shift > Creates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/shift_management_shift"
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "proxy-enabled": false
  },
  "servers": [
    {
      "url": "https://api.factorialhr.com",
      "description": "Production server"
    },
    {
      "url": "https://api.demo.factorial.dev",
      "description": "Demo server (deprecated)"
    },
    {
      "url": "https://api.eu2.demo.factorial.dev",
      "description": "Demo server"
    }
  ],
  "security": [
    {
      "oauth2": []
    }
  ],
  "components": {
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://id.factorialhr.com/oauth/authorize",
            "tokenUrl": "https://id.factorialhr.com/api/oauth/token",
            "refreshUrl": "https://id.factorialhr.com/api/oauth/token",
            "scopes": {
              "read": "Required for all operations",
              "write": "Required for write operations",
              "approvals": "Access to approvals",
              "banking": "Access to banking",
              "company_holidays": "Access to company holidays",
              "company_legal_entities": "Access to company legal entities",
              "company_locations": "Access to company locations",
              "compensations": "Access to compensations",
              "contracts": "Access to contracts",
              "custom_fields": "Access to custom fields",
              "documents": "Access to documents",
              "employee_updates": "Access to employee updates",
              "employees": "Access to employees",
              "expenses": "Access to expenses",
              "finance": "Access to finance",
              "integrations": "Access to integrations",
              "it_management": "Access to it management",
              "job_catalog": "Access to job catalog",
              "marketplace": "Access to marketplace",
              "payroll": "Access to payroll",
              "payroll_supplements": "Access to payroll supplements",
              "performance": "Access to performance",
              "posts": "Access to posts",
              "processes": "Access to processes",
              "project_management_expenses": "Access to project management expenses",
              "project_management_projects": "Access to project management projects",
              "project_management_time": "Access to project management time",
              "recruitment": "Access to recruitment",
              "shift_management": "Access to shift management",
              "tasks": "Access to tasks",
              "time_off": "Access to time off",
              "time_tracking": "Access to time tracking",
              "trainings": "Access to trainings"
            }
          }
        }
      }
    },
    "schemas": {
      "shift_management_shift": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "state",
          "employee_id",
          "start_at",
          "end_at",
          "extra_hours",
          "timezone",
          "local_start_at",
          "local_end_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the shift",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "Identifier of the company that owns this shift",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Display name of the shift. If not explicitly set, falls back to the default shift title or template week name",
            "example": "Morning shift"
          },
          "state": {
            "type": "string",
            "description": "Current state of the shift. 'draft' means the shift is not yet visible to employees, 'published' means it's visible and confirmed, 'backup' indicates a backup shift that can be replaced",
            "enum": [
              "draft",
              "published",
              "backup"
            ],
            "example": "draft"
          },
          "location_id": {
            "type": "string",
            "description": "Identifier of the location where the shift takes place. Can be null if the shift uses the employee's default location",
            "example": "3"
          },
          "locations_work_area_id": {
            "type": "string",
            "description": "Identifier of the specific work area within the location where the shift occurs. Work areas allow further subdivision of locations",
            "example": "5"
          },
          "employee_id": {
            "type": "string",
            "description": "Identifier of the employee assigned to this shift",
            "example": "1"
          },
          "start_at": {
            "type": "string",
            "description": "Timestamp indicating when the shift starts",
            "example": "2020-09-07T06:00:00.000+00:00"
          },
          "end_at": {
            "type": "string",
            "description": "Timestamp indicating when the shift ends",
            "example": "2020-09-07T15:00:00.000+00:00"
          },
          "notes": {
            "type": "string",
            "description": "Optional notes or comments about the shift, visible to managers and schedulers",
            "example": "This is a shift note"
          },
          "extra_hours": {
            "type": "boolean",
            "description": "Indicates whether this shift counts as extra hours beyond the employee's regular schedule. Used for overtime calculations",
            "example": false
          },
          "default_shift_title": {
            "type": "string",
            "description": "Title from the default shift template that was used to create this shift, if applicable",
            "example": "Morning shift"
          },
          "timezone": {
            "type": "string",
            "description": "IANA timezone identifier (e.g., 'Europe/Madrid', 'America/New_York') used to display the shift times in the local timezone",
            "example": "Europe/Madrid"
          },
          "local_start_at": {
            "type": "string",
            "description": "Start time of the shift converted to the local timezone. This is what employees see in their schedule",
            "example": "2020-09-07T08:00:00.000+00:00"
          },
          "local_end_at": {
            "type": "string",
            "description": "End time of the shift converted to the local timezone. This is what employees see in their schedule",
            "example": "2020-09-07T17:00:00.000+00:00"
          }
        }
      }
    }
  }
}
```