Add Leave Record

Allow customer to add leave record for the user.

• This API endpoint can add new leave type for the staff. Before you use this endpoint, you can get leave type name form the endpoint Get leave type by country.

• unique_identifier: Choose either email/staff_id to be unique_identifier.

post

Authentication: required

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/jsonmultipart/form-data

customer_idstringRequired

unique_identifierstringRequired

emailstring · nullableOptional

staff_idstring · nullableOptional

leave_typestringRequired

countrystringRequired

langstringOptionalDefault: EN

entitlement_daysstringRequired

effective_datestring · date · nullableRequired

carried_daysstring · nullableOptional

carried_expiry_datestring · date · nullableOptional

notesstring · nullableOptional

Responses

200

Success!

application/json

idinteger · int64OptionalDefault: 9956

userinteger · int64OptionalDefault: 9059

notesstringOptional

carriedinteger · int64Optional

countrystringOptionalDefault: MY

created_atstringOptionalDefault: 2025-11-13

leave_typestringOptionalDefault: Annual Leave

customer_idinteger · int64OptionalDefault: 255

entitlementinteger · int64OptionalDefault: 2

effective_datestringOptionalDefault: 2025-11-01

platform_emailstring · emailOptionalDefault: [email protected]

last_modified_byinteger · int64OptionalDefault: 8001

carried_expiry_datestringOptionalDefault: 2026-03-31

400

Input Error. Check the request payload for issues.

401

Unauthorized

403

Access denied. Additional privileges are needed access the requested resource.

404

Not Found. The requested resource does not exist.

429

Rate Limited. Too many requests.

500

Unexpected error

post

/add-ee-leave-details

HTTPcURLJavaScriptPython

POST /api:3C1oOcml/add-ee-leave-details HTTP/1.1
Host: api.marcopayroll.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 272

{
  "lang": "EN",
  "email": "[email protected]",
  "notes": null,
  "country": "MY",
  "staff_id": 1234567,
  "leave_type": "Annual Leave",
  "customer_id": "255",
  "carried_days": null,
  "effective_date": "2025-11-01",
  "entitlement_days": "2",
  "unique_identifier": "email",
  "carried_expiry_date": "2026-03-31"
}

application/jsonmultipart/form-data

{
  "id": 9956,
  "user": 9059,
  "notes": "text",
  "carried": 1,
  "country": "MY",
  "created_at": "2025-11-13",
  "leave_type": "Annual Leave",
  "customer_id": 255,
  "entitlement": 2,
  "effective_date": "2025-11-01",
  "platform_email": "[email protected]",
  "last_modified_by": 8001,
  "carried_expiry_date": "2026-03-31"
}