> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Rippling

The Rippling connector lets your AI agent act in each user's Rippling account. Each user connects their own Rippling access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 29 tools.

**Authentication:** Bearer Token
**Categories:** Productivity
**Tools:** 29: 23 read, 6 write, 0 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=RIPPLING)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Rippling connection

   In **AgentKit > Connections**, create a Rippling connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'rippling'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Rippling:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'rippling_current_user_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "rippling"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Rippling:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="rippling_current_user_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Rippling credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'rippling_company_list',
  toolInput: {},
  connector: 'rippling',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="rippling_company_list",
    tool_input={},
    connection_name="rippling",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `rippling_company_list`

List Companies · Read-only

List the Rippling company the API token belongs to.
Returns the company with id, name, legal name, doing-business-as name, primary email, phone, addresses and its legal entity structure.
Use this to read the company record or confirm which company the connection is bound to. Use rippling_current_user_get for the token owner.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor for the companies list. Leave empty for the first page. For the next page, take the cursor query parameter from the previous response's next_link; when next_link is null there are no more pages. Example: cD01ODNmZDg5MDA1ZWQyMzNmOGYxZGY0Zjk=.
- `expand` (`string`, optional): Comma-separated related objects to return inline instead of only their IDs. Allowed: parent_legal_entity, legal_entities. Example: legal_entities.
- `limit` (`integer`, optional): Maximum number of companies to return in one page, from 1 to 100. Defaults to 50. Example: 50. Default: `50`.
- `order_by` (`string`, optional): Sort order: id, created_at or updated_at, optionally followed by asc or desc (ascending is the default). Separate several fields with commas. Example: created_at desc.

Example input: `{}`

### `rippling_current_user_get`

Get Current User · Read-only

Get the Rippling identity behind the connected API token.
Returns the token owner's id, work email and company id, and the company when expanded.
Use this to find out who the connection acts as. Use rippling_user_get for any other user.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `expand` (`string`, optional): Comma-separated related objects to return inline instead of only their IDs. Allowed: company. Example: company.

Example input: `{}`

### `rippling_custom_field_list`

List Custom Fields · Read-only

List the custom fields defined in the Rippling company.
Returns a page of custom fields with id, name, description, type, whether it is required, and its options, plus next_link for the next page.
Use this to learn which custom fields exist and what their values mean.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor for the custom fields list. Leave empty for the first page. For the next page, take the cursor query parameter from the previous response's next_link; when next_link is null there are no more pages. Example: cD01ODNmZDg5MDA1ZWQyMzNmOGYxZGY0Zjk=.
- `limit` (`integer`, optional): Maximum number of custom fields to return in one page, from 1 to 100. Defaults to 50. Example: 50. Default: `50`.
- `order_by` (`string`, optional): Sort order: id, created_at or updated_at, optionally followed by asc or desc (ascending is the default). Separate several fields with commas. Example: created_at desc.

Example input: `{}`

### `rippling_department_get`

Get Department · Read-only

Get one Rippling department by ID.
Returns the department's name, parent id, reference code and department hierarchy, and the expanded parent when asked.
Use this when you have a department ID. Use rippling_department_list to browse departments.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `department_id` (`string`, required): The ID of the department to retrieve. Get it from rippling_department_list. Example: 66fb9df422242346857e04a1.
- `expand` (`string`, optional): Comma-separated related objects to return inline instead of only their IDs. Allowed: parent, department_hierarchy. Example: parent.

Example input: `{"department_id":"<department_id>"}`

### `rippling_department_list`

List Departments · Read-only

List departments in the Rippling company.
Returns a page of departments with id, name, parent id, reference code and department hierarchy, plus next_link for the next page.
Use this to find a department ID. Use rippling_department_get for one department.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor for the departments list. Leave empty for the first page. For the next page, take the cursor query parameter from the previous response's next_link; when next_link is null there are no more pages. Example: cD01ODNmZDg5MDA1ZWQyMzNmOGYxZGY0Zjk=.
- `expand` (`string`, optional): Comma-separated related objects to return inline instead of only their IDs. Allowed: parent, department_hierarchy. Example: parent.
- `limit` (`integer`, optional): Maximum number of departments to return in one page, from 1 to 100. Defaults to 50. Example: 50. Default: `50`.
- `order_by` (`string`, optional): Sort order: id, created_at or updated_at, optionally followed by asc or desc (ascending is the default). Separate several fields with commas. Example: created_at desc.

Example input: `{}`

### `rippling_leave_balance_get`

Get Leave Balance · Read-only

Get one Rippling leave balance by ID.
Returns the worker id, leave type id and the remaining balance with and without future approved leave.
Use this when you have a leave balance ID. Use rippling_leave_balance_list to find balances by worker or leave type.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `leave_balance_id` (`string`, required): The ID of the leave balance to retrieve. Get it from rippling_leave_balance_list. Example: 66fb9df422242346857e0507.
- `expand` (`string`, optional): Comma-separated related objects to return inline instead of only their IDs. Allowed: worker, leave_type. Example: leave_type.

Example input: `{"leave_balance_id":"<leave_balance_id>"}`

### `rippling_leave_balance_list`

List Leave Balances · Read-only

List workers' remaining time off per leave type in Rippling, optionally filtered by worker or leave type.
Returns a page of leave balances with id, worker id, leave type id and the remaining balance with and without future approved leave, plus next_link for the next page.
Use this to check how much time off a worker has. Use rippling_leave_balance_get for one balance by ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor for the leave balances list. Leave empty for the first page. For the next page, take the cursor query parameter from the previous response's next_link; when next_link is null there are no more pages. Example: cD01ODNmZDg5MDA1ZWQyMzNmOGYxZGY0Zjk=.
- `expand` (`string`, optional): Comma-separated related objects to return inline instead of only their IDs. Allowed: worker, leave_type. Example: leave_type.
- `filter` (`string`, optional): Filter expression using the operators eq, ne, gt, ge, lt, le, in, and, or, with string values in single quotes. Filterable fields: worker_id, leave_type_id. Example: worker_id eq '66fb9df122242346857e0458'.
- `limit` (`integer`, optional): Maximum number of leave balances to return in one page, from 1 to 100. Defaults to 50. Example: 50. Default: `50`.
- `order_by` (`string`, optional): Sort order: id, created_at or updated_at, optionally followed by asc or desc (ascending is the default). Separate several fields with commas. Example: created_at desc.

Example input: `{}`

### `rippling_leave_request_get`

Get Leave Request · Read-only

Get one Rippling time-off request by ID.
Returns the worker id, status, start and end dates and times, leave type, comments, reviewer, minutes requested and days taken off.
Use this when you have a leave request ID. Use rippling_leave_request_list to search requests.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `leave_request_id` (`string`, required): The ID of the leave request to retrieve. Get it from rippling_leave_request_list. Example: 66a43405af71f094991bf94f.
- `expand` (`string`, optional): Comma-separated related objects to return inline instead of only their IDs. Allowed: worker, requester, leave_type, reviewer. Example: worker,leave_type.

Example input: `{"leave_request_id":"<leave_request_id>"}`

### `rippling_leave_request_list`

List Leave Requests · Read-only

List time-off requests in Rippling, optionally filtered by worker, status, reviewer or leave type.
Returns a page of leave requests with id, worker id, status, start and end dates, leave type, comments, minutes requested and days taken off, plus next_link for the next page.
Use this to find pending or upcoming leave. Use rippling_leave_request_get for one request by ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor for the leave requests list. Leave empty for the first page. For the next page, take the cursor query parameter from the previous response's next_link; when next_link is null there are no more pages. Example: cD01ODNmZDg5MDA1ZWQyMzNmOGYxZGY0Zjk=.
- `expand` (`string`, optional): Comma-separated related objects to return inline instead of only their IDs. Allowed: worker, requester, leave_type, reviewer. Example: worker,leave_type.
- `filter` (`string`, optional): Filter expression using the operators eq, ne, gt, ge, lt, le, in, and, or, with string values in single quotes. Filterable fields: worker_id, requester_id, reviewer_id, status, leave_policy_id, leave_type_id. Status values: PENDING, APPROVED, REJECTED, CANCELED. Example: status eq 'PENDING'.
- `limit` (`integer`, optional): Maximum number of leave requests to return in one page, from 1 to 100. Defaults to 50. Example: 50. Default: `50`.
- `order_by` (`string`, optional): Sort order: id, created_at or updated_at, optionally followed by asc or desc (ascending is the default). Separate several fields with commas. Example: created_at desc.

Example input: `{}`

### `rippling_leave_type_list`

List Leave Types · Read-only

List the leave types (such as Vacation or Sick) configured in the Rippling company.
Returns a page of leave types with id, type, name, description, whether it is paid and whether an external system manages it, plus next_link for the next page.
Use this to get a leave_type_id before creating a leave request or reading balances.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor for the leave types list. Leave empty for the first page. For the next page, take the cursor query parameter from the previous response's next_link; when next_link is null there are no more pages. Example: cD01ODNmZDg5MDA1ZWQyMzNmOGYxZGY0Zjk=.
- `filter` (`string`, optional): Filter expression using the operators eq, ne, gt, ge, lt, le, in, and, or, with string values in single quotes. Filterable fields: name. Example: name eq 'Vacation'.
- `limit` (`integer`, optional): Maximum number of leave types to return in one page, from 1 to 100. Defaults to 50. Example: 50. Default: `50`.
- `order_by` (`string`, optional): Sort order: id, created_at or updated_at, optionally followed by asc or desc (ascending is the default). Separate several fields with commas. Example: created_at desc.

Example input: `{}`

### `rippling_level_get`

Get Level · Read-only

Get one Rippling job level by ID.
Returns the level's name, parent id, global level, rank, track, description, scope of responsibilities and experience requirements.
Use this when you have a level ID. Use rippling_level_list to browse levels.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `level_id` (`string`, required): The ID of the level to retrieve. Get it from rippling_level_list or a worker's level. Example: 66fb9df422242346857e04f6.
- `expand` (`string`, optional): Comma-separated related objects to return inline instead of only their IDs. Allowed: parent, track. Example: track.

Example input: `{"level_id":"<level_id>"}`

### `rippling_level_list`

List Levels · Read-only

List job levels in the Rippling company.
Returns a page of levels with id, name, parent id, global level, rank, track id and description, plus next_link for the next page.
Use this to find a level ID or see the leveling ladder. Use rippling_level_get for one level.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor for the levels list. Leave empty for the first page. For the next page, take the cursor query parameter from the previous response's next_link; when next_link is null there are no more pages. Example: cD01ODNmZDg5MDA1ZWQyMzNmOGYxZGY0Zjk=.
- `expand` (`string`, optional): Comma-separated related objects to return inline instead of only their IDs. Allowed: parent, track. Example: track.
- `limit` (`integer`, optional): Maximum number of levels to return in one page, from 1 to 100. Defaults to 50. Example: 50. Default: `50`.
- `order_by` (`string`, optional): Sort order: id, created_at or updated_at, optionally followed by asc or desc (ascending is the default). Separate several fields with commas. Example: created_at desc.

Example input: `{}`

### `rippling_supergroup_get`

Get Supergroup · Read-only

Get one Rippling supergroup by ID.
Returns the group's name, display name, description, group type, app owner, parent and read-only flag.
Use this when you have a supergroup ID. Use rippling_supergroup_member_list for its members.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `supergroup_id` (`string`, required): The ID of the supergroup to retrieve. Get it from rippling_supergroup_list. Example: 66fb9df422242346857e0518.

Example input: `{"supergroup_id":"<supergroup_id>"}`

### `rippling_supergroup_list`

List Supergroups · Read-only

List supergroups (reusable attribute-based groups of people) in the Rippling company.
Returns a page of supergroups with id, name, display name, description, group type, app owner and read-only flag, plus next_link for the next page.
Use this to find a group ID. Use rippling_supergroup_member_list for the people in a group.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor for the supergroups list. Leave empty for the first page. For the next page, take the cursor query parameter from the previous response's next_link; when next_link is null there are no more pages. Example: cD01ODNmZDg5MDA1ZWQyMzNmOGYxZGY0Zjk=.
- `filter` (`string`, optional): Filter expression using the operators eq, ne, gt, ge, lt, le, in, and, or, with string values in single quotes. Filterable fields: app_owner_id, group_type. Example: app_owner_id eq '66fb9df422242346857e0529'.
- `limit` (`integer`, optional): Maximum number of supergroups to return in one page, from 1 to 100. Defaults to 50. Example: 50. Default: `50`.
- `order_by` (`string`, optional): Sort order: id, created_at or updated_at, optionally followed by asc or desc (ascending is the default). Separate several fields with commas. Example: created_at desc.

Example input: `{}`

### `rippling_supergroup_member_list`

List Supergroup Members · Read-only

List the people who are currently members of a Rippling supergroup.
Returns a page of members with id, full name, work email and worker id, plus next_link for the next page.
Use this to see who is in a group. Use rippling_supergroup_list to find the group ID first.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `supergroup_id` (`string`, required): The ID of the supergroup whose members to list. Get it from rippling_supergroup_list. Example: 66fb9df422242346857e0518.
- `cursor` (`string`, optional): Pagination cursor for the members list. Leave empty for the first page. For the next page, take the cursor query parameter from the previous response's next_link; when next_link is null there are no more pages. Example: cD01ODNmZDg5MDA1ZWQyMzNmOGYxZGY0Zjk=.
- `expand` (`string`, optional): Comma-separated related objects to return inline instead of only their IDs. Allowed: worker. Example: worker.
- `limit` (`integer`, optional): Maximum number of members to return in one page, from 1 to 100. Defaults to 50. Example: 50. Default: `50`.
- `order_by` (`string`, optional): Sort order: id, created_at or updated_at, optionally followed by asc or desc (ascending is the default). Separate several fields with commas. Example: created_at desc.

Example input: `{"supergroup_id":"<supergroup_id>"}`

### `rippling_team_get`

Get Team · Read-only

Get one Rippling team by ID.
Returns the team's name and parent team id, and the expanded parent when asked.
Use this when you have a team ID. Use rippling_team_list to browse teams.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): The ID of the team to retrieve. Get it from rippling_team_list. Example: 66fb9df422242346857e04c3.
- `expand` (`string`, optional): Comma-separated related objects to return inline instead of only their IDs. Allowed: parent. Example: parent.

Example input: `{"team_id":"<team_id>"}`

### `rippling_team_list`

List Teams · Read-only

List teams in the Rippling company.
Returns a page of teams with id, name and parent team id, plus next_link for the next page.
Use this to find a team ID. Use rippling_team_get for one team.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor for the teams list. Leave empty for the first page. For the next page, take the cursor query parameter from the previous response's next_link; when next_link is null there are no more pages. Example: cD01ODNmZDg5MDA1ZWQyMzNmOGYxZGY0Zjk=.
- `expand` (`string`, optional): Comma-separated related objects to return inline instead of only their IDs. Allowed: parent. Example: parent.
- `limit` (`integer`, optional): Maximum number of teams to return in one page, from 1 to 100. Defaults to 50. Example: 50. Default: `50`.
- `order_by` (`string`, optional): Sort order: id, created_at or updated_at, optionally followed by asc or desc (ascending is the default). Separate several fields with commas. Example: created_at desc.

Example input: `{}`

### `rippling_user_get`

Get User · Read-only

Get one Rippling user (person and login account) by ID.
Returns the user's active flag, username, name, emails, phone numbers, addresses, photos, locale and timezone.
Use this when you have a user ID, for example a worker's user_id. Use rippling_user_list to browse users.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `user_id` (`string`, required): The ID of the user to retrieve. Get it from rippling_user_list or from a worker's user_id. Example: 66fb9df122242346857e0459.

Example input: `{"user_id":"<user_id>"}`

### `rippling_user_list`

List Users · Read-only

List users (the people and login accounts) in the Rippling company.
Returns a page of users with id, active flag, username, name, emails, phone numbers, addresses, locale and timezone, plus next_link for the next page.
Use this for identity and contact details. Use rippling_worker_list for employment data such as title, manager or department.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor for the users list. Leave empty for the first page. For the next page, take the cursor query parameter from the previous response's next_link; when next_link is null there are no more pages. Example: cD01ODNmZDg5MDA1ZWQyMzNmOGYxZGY0Zjk=.
- `limit` (`integer`, optional): Maximum number of users to return in one page, from 1 to 100. Defaults to 50. Example: 50. Default: `50`.
- `order_by` (`string`, optional): Sort order: id, created_at or updated_at, optionally followed by asc or desc (ascending is the default). Separate several fields with commas. Example: created_at desc.

Example input: `{}`

### `rippling_work_location_get`

Get Work Location · Read-only

Get one Rippling work location by ID.
Returns the location's name and address (street, city, region, postal code, country).
Use this when you have a work location ID. Use rippling_work_location_list to browse locations.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `work_location_id` (`string`, required): The ID of the work location to retrieve. Get it from rippling_work_location_list or a worker's location. Example: 66fb9df422242346857e04e5.

Example input: `{"work_location_id":"<work_location_id>"}`

### `rippling_work_location_list`

List Work Locations · Read-only

List work locations (offices and other sites) in the Rippling company.
Returns a page of work locations with id, name and address, plus next_link for the next page.
Use this to find a work location ID. Use rippling_work_location_get for one location.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor for the work locations list. Leave empty for the first page. For the next page, take the cursor query parameter from the previous response's next_link; when next_link is null there are no more pages. Example: cD01ODNmZDg5MDA1ZWQyMzNmOGYxZGY0Zjk=.
- `limit` (`integer`, optional): Maximum number of work locations to return in one page, from 1 to 100. Defaults to 50. Example: 50. Default: `50`.
- `order_by` (`string`, optional): Sort order: id, created_at or updated_at, optionally followed by asc or desc (ascending is the default). Separate several fields with commas. Example: created_at desc.

Example input: `{}`

### `rippling_worker_get`

Get Worker · Read-only

Get one Rippling worker (employment record) by ID.
Returns the worker's status, title, work email, manager, department, level, teams, employment type, location, start and end dates, and expanded objects you ask for.
Use this when you have a worker ID. Use rippling_worker_list to find one by status or work email.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `worker_id` (`string`, required): The ID of the worker to retrieve. Get it from rippling_worker_list. Example: 66fb9df122242346857e0458.
- `expand` (`string`, optional): Comma-separated related objects to return inline instead of only their IDs. Allowed: user, manager, legal_entity, employment_type, compensation, department. Example: user,manager.

Example input: `{"worker_id":"<worker_id>"}`

### `rippling_worker_list`

List Workers · Read-only

List workers (employment records) in the Rippling company, optionally filtered by status, work email or user.
Returns a page of workers with id, user id, status, title, work email, manager, department, employment type, start and end dates, plus next_link for the next page.
Use this to find a worker ID or build a roster. Use rippling_worker_get for one worker, and rippling_user_list for login accounts.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Pagination cursor for the workers list. Leave empty for the first page. For the next page, take the cursor query parameter from the previous response's next_link; when next_link is null there are no more pages. Example: cD01ODNmZDg5MDA1ZWQyMzNmOGYxZGY0Zjk=.
- `expand` (`string`, optional): Comma-separated related objects to return inline instead of only their IDs. Allowed: user, manager, legal_entity, employment_type, compensation, department. Example: user,department.
- `filter` (`string`, optional): Filter expression using the operators eq, ne, gt, ge, lt, le, in, and, or, with string values in single quotes. Filterable fields: status, work_email, user_id, created_at, updated_at. Worker status values: INIT, HIRED, ACCEPTED, ACTIVE, TERMINATED. Example: status eq 'ACTIVE'.
- `limit` (`integer`, optional): Maximum number of workers to return in one page, from 1 to 100. Defaults to 50. Example: 50. Default: `50`.
- `order_by` (`string`, optional): Sort order: id, created_at or updated_at, optionally followed by asc or desc (ascending is the default). Separate several fields with commas. Example: created_at desc.

Example input: `{}`

### `rippling_department_create`

Create Department · Write

Create a department in Rippling, optionally under a parent department.
Returns the new department with its id, name, parent id and reference code.
Use this to add a department. Use rippling_department_update to rename or move an existing one.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the new department. Example: Customer Success.
- `parent_id` (`string`, optional): ID of the parent department, to nest the new department under it. Leave empty for a top-level department. Get it from rippling_department_list. Example: 66fb9df422242346857e04a1.
- `reference_code` (`string`, optional): Your own reference code for the department, for example a code from another HR or finance system. Example: CS-100.

Example input: `{"name":"<name>"}`

### `rippling_department_update`

Update Department · Write

Update a Rippling department's name, parent department or reference code. Only the fields you pass are changed.
Returns the updated department.
Use this to rename or move a department. Use rippling_department_create for a new one.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `department_id` (`string`, required): The ID of the department to update. Get it from rippling_department_list. Example: 66fb9df422242346857e04a1.
- `name` (`string`, optional): New name for the department. Example: Customer Success.
- `parent_id` (`string`, optional): ID of the new parent department, to move the department. Get it from rippling_department_list. Example: 66fb9df422242346857e04b2.
- `reference_code` (`string`, optional): New reference code for the department. Example: CS-200.

Example input: `{"department_id":"<department_id>"}`

### `rippling_leave_request_create`

Create Leave Request · Write

Create a time-off request for a Rippling worker for a date range, as pending approval or already approved.
Returns the new leave request with id, status, dates, minutes requested and the days taken off.
Use this to book leave. Call rippling_leave_type_list first for the leave_type_id, and rippling_leave_balance_list to check the balance.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end_date` (`string`, required): Last day of leave, inclusive (YYYY-MM-DD). Example: 2026-06-05.
- `start_date` (`string`, required): First day of leave (YYYY-MM-DD). Example: 2026-06-01.
- `status` (`string`, required): Status of the new request: PENDING to send it for approval, or APPROVED to record already-approved leave. Example: PENDING. One of: `PENDING`, `APPROVED`, `REJECTED`, `CANCELED`.
- `worker_id` (`string`, required): ID of the worker taking the leave. Get it from rippling_worker_list. Example: 6569928afb7bc7c3510f460f.
- `comments` (`string`, optional): Comments on the request. On an approved, rejected or canceled request, comments are the only field that can change. Example: Family vacation.
- `end_date_custom_hours` (`number`, optional): Number of hours to take off on the end date, for a partial last day. Example: 4.
- `end_time` (`string`, optional): End time on the last day, for partial-day leave (24-hour HH:MM). Leave empty for full days. Example: 17:00.
- `leave_event_id` (`string`, optional): ID of the leave event the request belongs to, if any. Example: 66a43405af71f094991bf960.
- `leave_policy_id` (`string`, optional): ID of the leave policy, if you have one from an existing request. Rippling has no endpoint to list policies, so prefer leave_type_id. Provide leave_type_id or leave_policy_id. Example: 65699295fb7bc7c3510f4080.
- `leave_type_id` (`string`, optional): ID of the leave type, such as Vacation. Get it from rippling_leave_type_list. Provide leave_type_id or leave_policy_id. Example: 65699295fb7bc7c3510f4075.
- `reason_for_leave` (`string`, optional): Reason for the leave. Example: Medical appointment.
- `requester_id` (`string`, optional): ID of the worker who submitted the request, when it is not the worker taking leave. Example: 6569928afb7bc7c3510f4611.
- `reviewed_at` (`string`, optional): When the request was reviewed, as an ISO 8601 timestamp. Example: 2026-06-02T09:30:00Z.
- `reviewer_id` (`string`, optional): ID of the worker who reviewed the request. Example: 6569928afb7bc7c3510f4622.
- `start_date_custom_hours` (`number`, optional): Number of hours to take off on the start date, for a partial first day. Example: 4.
- `start_time` (`string`, optional): Start time on the first day, for partial-day leave (24-hour HH:MM). Leave empty for full days. Example: 13:00.

Example input: `{"end_date":"<end_date>","start_date":"<start_date>","status":"PENDING","worker_id":"<worker_id>"}`

### `rippling_leave_request_update`

Update Leave Request · Write

Update a Rippling time-off request: edit a pending request's dates or details, change its comments, or approve, reject or cancel it.
Returns the updated leave request.
Send a status change in its own call with the current worker_id, start_date and end_date. To change the dates of approved leave, cancel it and create a new request with rippling_leave_request_create.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `end_date` (`string`, required): Last day of leave (YYYY-MM-DD). Pass the current value when changing only status or comments. Example: 2026-06-12.
- `leave_request_id` (`string`, required): The ID of the leave request to update. Get it from rippling_leave_request_list. Example: 66a43405af71f094991bf94f.
- `start_date` (`string`, required): First day of leave (YYYY-MM-DD). Pass the current value when changing only status or comments. Only a PENDING request's dates can change. Example: 2026-06-08.
- `worker_id` (`string`, required): The worker on the request, sent as its current value. Get it from rippling_leave_request_get. Example: 6569928afb7bc7c3510f460f.
- `comments` (`string`, optional): Comments on the request. On an approved, rejected or canceled request, comments are the only field that can change. Example: Family vacation.
- `end_date_custom_hours` (`number`, optional): Number of hours to take off on the end date, for a partial last day. Example: 4.
- `end_time` (`string`, optional): End time on the last day, for partial-day leave (24-hour HH:MM). Leave empty for full days. Example: 17:00.
- `leave_event_id` (`string`, optional): ID of the leave event the request belongs to, if any. Example: 66a43405af71f094991bf960.
- `leave_policy_id` (`string`, optional): ID of the leave policy, if you have one from an existing request. Rippling has no endpoint to list policies, so prefer leave_type_id. Example: 65699295fb7bc7c3510f4080.
- `leave_type_id` (`string`, optional): ID of the leave type, such as Vacation. Get it from rippling_leave_type_list. Example: 65699295fb7bc7c3510f4075.
- `reason_for_leave` (`string`, optional): Reason for the leave. Example: Medical appointment.
- `requester_id` (`string`, optional): ID of the worker who submitted the request, when it is not the worker taking leave. Example: 6569928afb7bc7c3510f4611.
- `reviewed_at` (`string`, optional): When the request was reviewed, as an ISO 8601 timestamp. Example: 2026-06-02T09:30:00Z.
- `reviewer_id` (`string`, optional): ID of the worker who reviewed the request. Example: 6569928afb7bc7c3510f4622.
- `start_date_custom_hours` (`number`, optional): Number of hours to take off on the start date, for a partial first day. Example: 4.
- `start_time` (`string`, optional): Start time on the first day, for partial-day leave (24-hour HH:MM). Leave empty for full days. Example: 13:00.
- `status` (`string`, optional): New status. Send a status change on its own: change only status in that call and pass the current worker_id, start_date and end_date. Set CANCELED to cancel a request. Example: APPROVED. One of: `PENDING`, `APPROVED`, `REJECTED`, `CANCELED`.

Example input: `{"end_date":"<end_date>","leave_request_id":"<leave_request_id>","start_date":"<start_date>","worker_id":"<worker_id>"}`

### `rippling_team_create`

Create Team · Write

Create a team in Rippling, optionally under a parent team.
Returns the new team with its id, name and parent id.
Use this to add a team. Use rippling_team_update to rename or move an existing one.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the new team. Example: Platform Team.
- `parent_id` (`string`, optional): ID of the parent team, to nest the new team under it. Leave empty for a top-level team. Get it from rippling_team_list. Example: 66fb9df422242346857e04c3.

Example input: `{"name":"<name>"}`

### `rippling_team_update`

Update Team · Write

Update a Rippling team's name or parent team. Only the fields you pass are changed.
Returns the updated team.
Use this to rename or move a team. Use rippling_team_create for a new one.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): The ID of the team to update. Get it from rippling_team_list. Example: 66fb9df422242346857e04c3.
- `name` (`string`, optional): New name for the team. Example: Platform Team.
- `parent_id` (`string`, optional): ID of the new parent team, to move the team. Get it from rippling_team_list. Example: 66fb9df422242346857e04d4.

Example input: `{"team_id":"<team_id>"}`

## Related

Other Productivity connectors ([all 203](/agentkit/connectors/?category=productivity)):

- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Google Workspace (DWD)](/agentkit/connectors/googledwd/): Scalekit connector, Service account, 100 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
