For AI agents: visit https://developer.shyftplan.com/llms.txt for an index of all pages formatted in Markdown and endpoints in OpenAPI.

Jump to Content

API Reference Changelog Changelog Policy Webhooks API Support

v1.0

API Reference

v1.0API Reference Changelog Changelog Policy Webhooks API Support

Introduction

Getting started with the shyftplan API
Which method do I want? (Get, Post, Put, Delete)
GraphQL Guide

Use Cases

Demand-driven shift updates

shyftplan API reference

absences
absence_entitlements
- v2/absence_entitlementsget
- v2/absence_entitlementsput
absence_reasons
assignment_groups
availabilities
availability_aggregations
- v1/availability_aggregationsget
available_global_qualifications
- v1/available_global_qualificationsget
background_jobs
bulk_requests
- v1/bulk_requestspost
- v1/bulk_requests/{id}get
calendar
- v1/calendar/aggregationsget
chat_messages
companies
custom_fields
employee_evaluations
employments
employments_api_tokens
employments_paygrades
- v1/employments_paygradesget
employments_positions
employments_qualifications
employments_rotation_groups
employments_surveys
- v1/employments_surveys/{id}get
- v1/employments_surveys/{id}post
employment_time_accounts
- v1/employment_time_accountsget
- v1/employment_time_accountspatch
evaluations
evaluation_breaks
- v1/evaluation_breaksget
evaluation_tags
external_record_mappings
hour_accounts
individual_rotations
languages
- v1/languagesget
live_staff_shifts
- v1/live_staff_shiftsget
locations
locations_positions
locations_positions_tags
locations_position_qualifications
login
- v1/loginpost
newsfeeds
- v1/newsfeedsget
- v1/newsfeedspost
notification_configurations
paygrade_types
- v1/paygrade_typesget
- v1/paygrade_types/{id}get
payments
- v1/payments/{staff_shift_id}get
payslips
- v1/payslipsget
- v1/payslipspost
positions
punch_events
- /api/v1/punch_eventsget
punch_timings
qualifications
qualification_matrix_employments
replaced_evaluations
- v1/replaced_evaluationsget
replace_requests
- v1/replace_requests/{id}del
requests
rights
sessions
- v1/sessions/refreshpost
shiftplans
shifts
shifts_tags
- v1/shifts_tagsget
- v1/shifts_tags/{id}get
shift_assignment_groups
- v1/shift_assignment_groupsget
shift_breaks
- v1/shift_breaksget
shift_presets
- v1/shift_presetsget
- v1/shift_presetspost
shift_rotations
shift_rotation_groups
special_dates
sso_settings
- v1/sso_settings/sso_target_urlget
staff_shifts
staff_shifts_tags
tags
time_recordings
ui_filters
- v1/ui_filtersget
- v1/ui_filtersput
users

Powered by

v1/positions

post

https://shyftplan.com/api/v1/positions

Create a new Position

Body Params

user_email

string

required

This is a testing sandbox. We advise against using credentials for production accounts here.

E-mail address of the API user.

authentication_token

string

required

This is a testing sandbox. We advise against using credentials for production accounts here.

Authentication token - can be fetched by login action.

company_id

int32

required

≥ 1

ID of a shyftplan account.

name

string

required

Name

color

string

Color (HEX format, e.g. #FF00FF)

description

string

Description

metadata

string

Position metadata as json

note

string

Position Comment (Shown on Shift)

sort

int32

Used to order Positions in the UI

Response

201

Create a new Position

Updated 3 months ago

v1/positions/{id}

Did this page help you?

Language

Loading…

Response

Click Try It! to start a request and see the response here!

Updated 3 months ago

v1/positions/{id}

Did this page help you?