Skip to main content
This guide will help you make your first request to the Tomorro API.

​
Step 1: Get your API key

To authenticate with the Tomorro API, you need an API key.
1

Log in to Tomorro

Go to app.tomorro.com and sign in to your account.
2

Navigate to API Settings

Go to Settings → API in your organization dashboard.
3

Generate an API Key

Click Create API Key, give it a name, and copy the generated key.
Store your API key securely. It won’t be shown again after you leave the page.

​
Step 2: Make your first request

Let’s list the members in your organization. Replace your-api-key with your actual API key. 
curl -X GET "https://api.tomorro.com/members" \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json"
You should receive a response like this: 
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "user": {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "username": "john.doe@example.com",
        "firstname": "John",
        "lastname": "Doe"
      },
      "role": "admin",
      "status": "active",
      "contracts": [],
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "hasNext": false,
    "hasPrevious": false,
    "nextCursor": null,
    "previousCursor": null
  }
}

​
Step 3: Create a member

Now let’s create a new member in your organization: 
curl -X POST "https://api.tomorro.com/members" \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "jane.smith@example.com",
    "role": "user",
    "sendInvitation": true
  }'

​
Next steps

Now that you’ve made your first API calls, explore the full API capabilities:

API Reference

Learn about authentication, pagination, and error handling.

Members API

Explore all member management endpoints.