Add Pay Item for User

Allow customer to add pay item for user

• unique_identifier: Choose either email/staff_id as unique identifier

• frequency: One-Time/Hourly/Daily/Weekly/Bi-weekly/Semi-Monthly/Monthly/Quarterly/Half-Yearly/Yearly

• calculation_type: Gross/Net/CTC

post

Authentication: required

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

multipart/form-data

customer_idstringRequired

unique_identifierstringRequired

emailstring · nullableRequired

staff_idstring · nullableOptional

langstringOptionalDefault: EN

pay_item_countrystringRequired

pay_item_namestringRequired

frequencystringRequired

calculation_typestringRequired

currencystringRequired

valuestringRequired

effective_datestring · date · nullableRequired

end_datestring · date · nullableOptional

attachmentsstring · binary[] · nullableOptional

Responses

200

Success!

application/json

idinteger · int64OptionalDefault: 40299

userinteger · int64OptionalDefault: 11094

notesstringOptional

valueinteger · int64OptionalDefault: 10000

currencystringOptionalDefault: MYR

end_datestringOptional

pay_iteminteger · int64OptionalDefault: 3063

frequencystringOptionalDefault: Monthly

gross_netstringOptionalDefault: Gross

customer_idinteger · int64OptionalDefault: 255

effective_datestringOptionalDefault: 2026-01-01

platform_emailstring · emailOptionalDefault: [email protected]

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-pay-item

HTTPcURLJavaScriptPython

POST /api:3C1oOcml/add-ee-pay-item HTTP/1.1
Host: api.marcopayroll.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 300

{
  "customer_id": "text",
  "unique_identifier": "text",
  "email": "text",
  "staff_id": "text",
  "lang": "EN",
  "pay_item_country": "text",
  "pay_item_name": "text",
  "frequency": "text",
  "calculation_type": "text",
  "currency": "text",
  "value": "text",
  "effective_date": "2026-03-26",
  "end_date": "2026-03-26",
  "attachments": [
    "binary"
  ]
}

{
  "id": 40299,
  "user": 11094,
  "notes": "text",
  "value": 10000,
  "currency": "MYR",
  "end_date": "text",
  "pay_item": 3063,
  "frequency": "Monthly",
  "gross_net": "Gross",
  "customer_id": 255,
  "effective_date": "2026-01-01",
  "platform_email": "[email protected]"
}