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.
- Tools
- 29
- What they doRead · write · destructive
- 23 · 6 · 023 read6 write0 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Rippling connection
In AgentKit > Connections, create a Rippling connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'rippling'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'rippling_current_user_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "rippling"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="rippling_current_user_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Rippling credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolrippling_company_listList the Rippling company the API token belongs to.Read-onlyList Companies
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.
Inputs
cursorstring- 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=.
expandstring- Comma-separated related objects to return inline instead of only their IDs. Allowed: parent_legal_entity, legal_entities. Example: legal_entities.
limitinteger- Maximum number of companies to return in one page, from 1 to 100. Defaults to 50. Example: 50.default
50 order_bystring- 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.
rippling_current_user_getGet the Rippling identity behind the connected API token.Read-onlyGet Current User
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.
Inputs
expandstring- Comma-separated related objects to return inline instead of only their IDs. Allowed: company. Example: company.
rippling_custom_field_listList the custom fields defined in the Rippling company.Read-onlyList Custom Fields
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.
Inputs
cursorstring- 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=.
limitinteger- Maximum number of custom fields to return in one page, from 1 to 100. Defaults to 50. Example: 50.default
50 order_bystring- 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.
rippling_department_getGet one Rippling department by ID.Read-onlyGet Department
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.
Inputs
department_idstringrequired- The ID of the department to retrieve. Get it from rippling_department_list. Example: 66fb9df422242346857e04a1.
expandstring- Comma-separated related objects to return inline instead of only their IDs. Allowed: parent, department_hierarchy. Example: parent.
rippling_department_listList departments in the Rippling company.Read-onlyList Departments
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.
Inputs
cursorstring- 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=.
expandstring- Comma-separated related objects to return inline instead of only their IDs. Allowed: parent, department_hierarchy. Example: parent.
limitinteger- Maximum number of departments to return in one page, from 1 to 100. Defaults to 50. Example: 50.default
50 order_bystring- 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.
rippling_leave_balance_getGet one Rippling leave balance by ID.Read-onlyGet Leave Balance
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.
Inputs
leave_balance_idstringrequired- The ID of the leave balance to retrieve. Get it from rippling_leave_balance_list. Example: 66fb9df422242346857e0507.
expandstring- Comma-separated related objects to return inline instead of only their IDs. Allowed: worker, leave_type. Example: leave_type.
rippling_leave_balance_listList workers' remaining time off per leave type in Rippling, optionally filtered by worker or leave type.Read-onlyList Leave Balances
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.
Inputs
cursorstring- 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=.
expandstring- Comma-separated related objects to return inline instead of only their IDs. Allowed: worker, leave_type. Example: leave_type.
filterstring- 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'.
limitinteger- Maximum number of leave balances to return in one page, from 1 to 100. Defaults to 50. Example: 50.default
50 order_bystring- 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.
rippling_leave_request_getGet one Rippling time-off request by ID.Read-onlyGet Leave Request
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.
Inputs
leave_request_idstringrequired- The ID of the leave request to retrieve. Get it from rippling_leave_request_list. Example: 66a43405af71f094991bf94f.
expandstring- Comma-separated related objects to return inline instead of only their IDs. Allowed: worker, requester, leave_type, reviewer. Example: worker,leave_type.
rippling_leave_request_listList time-off requests in Rippling, optionally filtered by worker, status, reviewer or leave type.Read-onlyList Leave Requests
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.
Inputs
cursorstring- 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=.
expandstring- Comma-separated related objects to return inline instead of only their IDs. Allowed: worker, requester, leave_type, reviewer. Example: worker,leave_type.
filterstring- 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'.
limitinteger- Maximum number of leave requests to return in one page, from 1 to 100. Defaults to 50. Example: 50.default
50 order_bystring- 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.
rippling_leave_type_listList the leave types (such as Vacation or Sick) configured in the Rippling company.Read-onlyList Leave Types
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.
Inputs
cursorstring- 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=.
filterstring- 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'.
limitinteger- Maximum number of leave types to return in one page, from 1 to 100. Defaults to 50. Example: 50.default
50 order_bystring- 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.
rippling_level_getGet one Rippling job level by ID.Read-onlyGet Level
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.
Inputs
level_idstringrequired- The ID of the level to retrieve. Get it from rippling_level_list or a worker's level. Example: 66fb9df422242346857e04f6.
expandstring- Comma-separated related objects to return inline instead of only their IDs. Allowed: parent, track. Example: track.
rippling_level_listList job levels in the Rippling company.Read-onlyList Levels
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.
Inputs
cursorstring- 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=.
expandstring- Comma-separated related objects to return inline instead of only their IDs. Allowed: parent, track. Example: track.
limitinteger- Maximum number of levels to return in one page, from 1 to 100. Defaults to 50. Example: 50.default
50 order_bystring- 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.
rippling_supergroup_getGet one Rippling supergroup by ID.Read-onlyGet Supergroup
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.
Inputs
supergroup_idstringrequired- The ID of the supergroup to retrieve. Get it from rippling_supergroup_list. Example: 66fb9df422242346857e0518.
rippling_supergroup_listList supergroups (reusable attribute-based groups of people) in the Rippling company.Read-onlyList Supergroups
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.
Inputs
cursorstring- 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=.
filterstring- 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'.
limitinteger- Maximum number of supergroups to return in one page, from 1 to 100. Defaults to 50. Example: 50.default
50 order_bystring- 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.
rippling_supergroup_member_listList the people who are currently members of a Rippling supergroup.Read-onlyList Supergroup Members
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.
Inputs
supergroup_idstringrequired- The ID of the supergroup whose members to list. Get it from rippling_supergroup_list. Example: 66fb9df422242346857e0518.
cursorstring- 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=.
expandstring- Comma-separated related objects to return inline instead of only their IDs. Allowed: worker. Example: worker.
limitinteger- Maximum number of members to return in one page, from 1 to 100. Defaults to 50. Example: 50.default
50 order_bystring- 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.
rippling_team_getGet one Rippling team by ID.Read-onlyGet Team
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.
Inputs
team_idstringrequired- The ID of the team to retrieve. Get it from rippling_team_list. Example: 66fb9df422242346857e04c3.
expandstring- Comma-separated related objects to return inline instead of only their IDs. Allowed: parent. Example: parent.
rippling_team_listList teams in the Rippling company.Read-onlyList Teams
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.
Inputs
cursorstring- 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=.
expandstring- Comma-separated related objects to return inline instead of only their IDs. Allowed: parent. Example: parent.
limitinteger- Maximum number of teams to return in one page, from 1 to 100. Defaults to 50. Example: 50.default
50 order_bystring- 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.
rippling_user_getGet one Rippling user (person and login account) by ID.Read-onlyGet User
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.
Inputs
user_idstringrequired- The ID of the user to retrieve. Get it from rippling_user_list or from a worker's user_id. Example: 66fb9df122242346857e0459.
rippling_user_listList users (the people and login accounts) in the Rippling company.Read-onlyList Users
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.
Inputs
cursorstring- 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=.
limitinteger- Maximum number of users to return in one page, from 1 to 100. Defaults to 50. Example: 50.default
50 order_bystring- 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.
rippling_work_location_getGet one Rippling work location by ID.Read-onlyGet Work Location
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.
Inputs
work_location_idstringrequired- The ID of the work location to retrieve. Get it from rippling_work_location_list or a worker's location. Example: 66fb9df422242346857e04e5.
rippling_work_location_listList work locations (offices and other sites) in the Rippling company.Read-onlyList Work Locations
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.
Inputs
cursorstring- 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=.
limitinteger- Maximum number of work locations to return in one page, from 1 to 100. Defaults to 50. Example: 50.default
50 order_bystring- 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.
rippling_worker_getGet one Rippling worker (employment record) by ID.Read-onlyGet Worker
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.
Inputs
worker_idstringrequired- The ID of the worker to retrieve. Get it from rippling_worker_list. Example: 66fb9df122242346857e0458.
expandstring- Comma-separated related objects to return inline instead of only their IDs. Allowed: user, manager, legal_entity, employment_type, compensation, department. Example: user,manager.
rippling_worker_listList workers (employment records) in the Rippling company, optionally filtered by status, work email or user.Read-onlyList Workers
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.
Inputs
cursorstring- 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=.
expandstring- Comma-separated related objects to return inline instead of only their IDs. Allowed: user, manager, legal_entity, employment_type, compensation, department. Example: user,department.
filterstring- 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'.
limitinteger- Maximum number of workers to return in one page, from 1 to 100. Defaults to 50. Example: 50.default
50 order_bystring- 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.
rippling_department_createCreate a department in Rippling, optionally under a parent department.WriteCreate Department
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.
Inputs
namestringrequired- Name of the new department. Example: Customer Success.
parent_idstring- 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_codestring- Your own reference code for the department, for example a code from another HR or finance system. Example: CS-100.
rippling_department_updateUpdate a Rippling department's name, parent department or reference code.WriteUpdate Department
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.
- Idempotent
Inputs
department_idstringrequired- The ID of the department to update. Get it from rippling_department_list. Example: 66fb9df422242346857e04a1.
namestring- New name for the department. Example: Customer Success.
parent_idstring- ID of the new parent department, to move the department. Get it from rippling_department_list. Example: 66fb9df422242346857e04b2.
reference_codestring- New reference code for the department. Example: CS-200.
rippling_leave_request_createCreate a time-off request for a Rippling worker for a date range, as pending approval or already approved.WriteCreate Leave Request
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.
Inputs
end_datestringrequired- Last day of leave, inclusive (YYYY-MM-DD). Example: 2026-06-05.
start_datestringrequired- First day of leave (YYYY-MM-DD). Example: 2026-06-01.
statusstringrequired- Status of the new request: PENDING to send it for approval, or APPROVED to record already-approved leave. Example: PENDING.one of
PENDINGAPPROVEDREJECTEDCANCELED worker_idstringrequired- ID of the worker taking the leave. Get it from rippling_worker_list. Example: 6569928afb7bc7c3510f460f.
commentsstring- 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_hoursnumber- Number of hours to take off on the end date, for a partial last day. Example: 4.
end_timestring- End time on the last day, for partial-day leave (24-hour HH:MM). Leave empty for full days. Example: 17:00.
leave_event_idstring- ID of the leave event the request belongs to, if any. Example: 66a43405af71f094991bf960.
leave_policy_idstring- 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_idstring- 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_leavestring- Reason for the leave. Example: Medical appointment.
requester_idstring- ID of the worker who submitted the request, when it is not the worker taking leave. Example: 6569928afb7bc7c3510f4611.
reviewed_atstring- When the request was reviewed, as an ISO 8601 timestamp. Example: 2026-06-02T09:30:00Z.
reviewer_idstring- ID of the worker who reviewed the request. Example: 6569928afb7bc7c3510f4622.
start_date_custom_hoursnumber- Number of hours to take off on the start date, for a partial first day. Example: 4.
start_timestring- Start time on the first day, for partial-day leave (24-hour HH:MM). Leave empty for full days. Example: 13:00.
rippling_leave_request_updateUpdate a Rippling time-off request: edit a pending request's dates or details, change its comments, or approve, reject or cancel it.WriteUpdate Leave Request
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.
- Idempotent
Inputs
end_datestringrequired- Last day of leave (YYYY-MM-DD). Pass the current value when changing only status or comments. Example: 2026-06-12.
leave_request_idstringrequired- The ID of the leave request to update. Get it from rippling_leave_request_list. Example: 66a43405af71f094991bf94f.
start_datestringrequired- 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_idstringrequired- The worker on the request, sent as its current value. Get it from rippling_leave_request_get. Example: 6569928afb7bc7c3510f460f.
commentsstring- 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_hoursnumber- Number of hours to take off on the end date, for a partial last day. Example: 4.
end_timestring- End time on the last day, for partial-day leave (24-hour HH:MM). Leave empty for full days. Example: 17:00.
leave_event_idstring- ID of the leave event the request belongs to, if any. Example: 66a43405af71f094991bf960.
leave_policy_idstring- 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_idstring- ID of the leave type, such as Vacation. Get it from rippling_leave_type_list. Example: 65699295fb7bc7c3510f4075.
reason_for_leavestring- Reason for the leave. Example: Medical appointment.
requester_idstring- ID of the worker who submitted the request, when it is not the worker taking leave. Example: 6569928afb7bc7c3510f4611.
reviewed_atstring- When the request was reviewed, as an ISO 8601 timestamp. Example: 2026-06-02T09:30:00Z.
reviewer_idstring- ID of the worker who reviewed the request. Example: 6569928afb7bc7c3510f4622.
start_date_custom_hoursnumber- Number of hours to take off on the start date, for a partial first day. Example: 4.
start_timestring- Start time on the first day, for partial-day leave (24-hour HH:MM). Leave empty for full days. Example: 13:00.
statusstring- 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
PENDINGAPPROVEDREJECTEDCANCELED
rippling_team_createCreate a team in Rippling, optionally under a parent team.WriteCreate Team
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.
Inputs
namestringrequired- Name of the new team. Example: Platform Team.
parent_idstring- 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.
rippling_team_updateUpdate a Rippling team's name or parent team.WriteUpdate Team
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.
- Idempotent
Inputs
team_idstringrequired- The ID of the team to update. Get it from rippling_team_list. Example: 66fb9df422242346857e04c3.
namestring- New name for the team. Example: Platform Team.
parent_idstring- ID of the new parent team, to move the team. Get it from rippling_team_list. Example: 66fb9df422242346857e04d4.
No tools match.