# Introduction

Marco API extends the capabilities of the Marco Platform by allowing seamless integration into your HR workflows. With Marco API, you can programmatically manage your global workforce, automate payroll processes, and interact with your platform's data without switching between tools or systems. 

***

## Prerequisites for Using Marco API

Before you start using the API, make sure you have the following: 

1. **Account** - Create a Marco account. 
2. **Access Permissions (RBAC)** - Each user in Marco operates under Role-Based Access Control (RBAC). Access depends on your user role (e.g: Manager, Staff, Vendor Admin).\
   See [Role-Based Access Control (RBAC) ](/overview/role-based-access-control-rbac.md)for details on permissions.
3. **Authentication** - Obtain your [API authentication token](/overview/authentication.md). You will need this to securely access Marco API endpoints. You can request both `customer_id` and `vendor_id` from Marco.

## Build Your First API Call

The Marco API follows the RESTful standard and uses HTTPS for secure communication. You can use it in any programming language that supports HTTP requests (e.g: Python, JavaScript, or Java).

Your API call must include these components:

* **Authorization Header** \
  Include your [API Key](/overview/authentication.md) in the request header.
* **Request**\
  Use standard HTTP methods: 
  * GET - Retrieve data
  * POST - Send or insert data


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.marcopayroll.com/overview/introduction.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.