Getting started with Marco API

Marco API extends the capabilities of Marco Platform into your HR workflow. Use Marco API to programmatically manage your global workforce without having to switch existing tools and systems.

---

Prerequisites for using Marco API

Before you can start using the API, you need to do the following:

1. Account - Create a Marco account.

2. Authorization - Set up the appropriate access privilege for your Marco account.

3. Authentication - Get your API authentication token. You can apply for customer_id and vendor_id from Marco.

Authorization

Access to Marco API endpoints follow the same access privileges in Marco Platform.

For example, a user with time access will be able to view time-off records in Marco Platform, but only for their managed staff. Likewise, when the same user calls the get all user's time off record endpoint, they will only be able to retrieve time-off records for their managed staff.

To make an API call, ensure that your caller account has admin access. With admin access, you can manage all staff data in your company.

To set admin access for your account, contact Marco Payroll to set it for you. Once you have an account with admin access, you can use that account to set admin access for other accounts in your company.

Build your API call

Marco API is a RESTful API that uses the HTTPS protocol to send and access data. You can interact with the API endpoints through HTTP requests in any programming language.

Your API call must have the following components:

• A host: The host for Marco API requests is always https://api.marcopayroll.com/api:eZ5RDmx2/api/

• An Authorization header: An API Key must be included in the Authorization header.

• A request: When submitting data to a resource via POST or GET , you must submit your payload in JSON.