v1/mcp/preview/create_absences

post

https://shyftplan.com/api/v1/mcp/preview/create_absences

Compute the preview envelope for createAbsences (bulk).

Body Params

Compute the Preview envelope for createAbsences (bulk).

company_id

int32

required

≥ 1

ID of a shyftplan account.

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.

absence_reason_id

int32

required

≥ 1

ID of the absence reason.

employment_ids

array of objects

required

List of employment IDs.

employment_ids*

notes

string

Note saved with the object.

paid

boolean

Defaults to true

starts_at

date-time

required

Date-time (ISO 8601) for the begin of the object's span.

ends_at

date-time

required

Date-time (ISO 8601) for the end of the object's span.

Responses

201

Signed preview token + impact summary

400

MCP preview requires an EmploymentsApiToken

401

401 Unauthorized

403

Forbidden - caller lacks create absence permission

404

One or more employments / absence_reason not found

422

Invalid date range