---
title: "Getting Started"
source: "https://palt.ohmyteam.cc/getting-started"
---

# Getting Started

## Prerequisites

1. Sign up for a BambooHR account and note your company subdomain (e.g., `acme` for `acme.bamboohr.com`).
2. Generate an API key in your BambooHR account under **Account Settings > API Access**.
3. Ensure your user has the necessary permissions for the endpoints you plan to use.

## Making Your First API Call

Use Basic Authentication with your subdomain as the username and API key as the password.

### Example: Get Datasets

This endpoint lists available datasets for reports.

```bash
curl -X GET "https://<your-company>.bamboohr.com/api/v1/datasets" \
  -u "<your-company>:<api-key>"
```

**Response (200 OK):**

```json
{
  "datasets": [
    {
      "id": "example",
      "name": "Employee List"
    }
  ]
}
```

Replace `<your-company>` and `<api-key>` with your actual values. Test this in your terminal or an API client like Postman.