Skip to main content

​
Prerequisites

Before you begin, make sure you have:
1

A Sesame HR account

Sign up at sesamehr.com if you don’t have one
2

Admin access

You need admin permissions to generate API tokens

​
Step 1: Get Your API Token

1

Log in to Sesame HR

Go to app.sesametime.com and log in with your credentials
2

Navigate to API Settings

Go to Settings > Integrations > API
3

Generate a new token

Click Generate Token and copy the token immediately

​
Step 2: Make Your First Request

Test your token by fetching your account information: 
curl -X GET "https://api-{region}.sesametime.com/core/v3/info" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
You should receive a response like: 
{
  "data": {
    "company": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "Demo Company",
      "notificationEmail": "demo@example.com",
      "language": "en-GB",
      "createdAt": "2020-01-01T10:00:00+01:00",
      "updatedAt": "2020-01-01T10:00:00+01:00"
    }
  }
}

​
Step 3: List Your Employees

Now let’s fetch your employee list: 
curl -X GET "https://api-{region}.sesametime.com/core/v3/employees?limit=10" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

​
Common Use Cases

Now that you’re set up, explore these common integration scenarios:

Sync Employees

Keep your HR system in sync with Sesame

Automate Time Tracking

Build automated clock-in/out systems

Manage Vacations

Handle vacation requests programmatically

Integrate Payroll

Export time data for payroll processing

​
Next Steps

Authentication

Learn about token management and security

Error Handling

Handle errors gracefully

Rate Limiting

Understand API limits