AACFlow

Rippling

Manage workers, departments, custom objects, and company data in Rippling

Usage Instructions

Integrate Rippling Platform into your workflow. Manage workers, users, departments, teams, titles, work locations, business partners, supergroups, custom objects, custom apps, custom pages, custom settings, object categories, reports, and draft hires.

Tools

rippling_list_workers

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
filterstringNoNo description
expandstringNoNo description
orderBystringNoNo description
cursorstringNoNo description

Output

ParameterTypeDescription
workersarrayList of workers
idstringWorker ID
created_atstringRecord creation date
updated_atstringRecord update date
user_idstringAssociated user ID
is_managerbooleanWhether the worker is a manager
manager_idstringManager worker ID
legal_entity_idstringLegal entity ID
countrystringWorker country code
start_datestringEmployment start date
end_datestringEmployment end date
numbernumberWorker number
work_emailstringWork email address
personal_emailstringPersonal email address
statusstringWorker status (INIT, HIRED, ACCEPTED, ACTIVE, TERMINATED)
employment_type_idstringEmployment type ID
department_idstringDepartment ID
teams_idjsonArray of team IDs
titlestringJob title
level_idstringLevel ID
compensation_idstringCompensation ID
overtime_exemptionstringOvertime exemption status (EXEMPT, NON_EXEMPT)
title_effective_datestringTitle effective date
business_partners_idjsonArray of business partner IDs
locationjsonWorker location (type, work_location_id)
genderstringGender
date_of_birthstringDate of birth
racestringRace
ethnicitystringEthnicity
citizenshipstringCitizenship country code
termination_detailsjsonTermination details
custom_fieldsjsonCustom fields (expandable)
country_fieldsjsonCountry-specific fields
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_get_worker

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description
expandstringNoNo description

Output

ParameterTypeDescription
idstringWorker ID
created_atstringCreation date
updated_atstringUpdate date
user_idstringUser ID
is_managerbooleanIs manager
manager_idstringManager ID
legal_entity_idstringLegal entity ID
countrystringCountry
start_datestringStart date
end_datestringEnd date
numbernumberWorker number
work_emailstringWork email
personal_emailstringPersonal email
statusstringStatus
employment_type_idstringEmployment type ID
department_idstringDepartment ID
teams_idjsonTeam IDs
titlestringJob title
level_idstringLevel ID
compensation_idstringCompensation ID
overtime_exemptionstringOvertime exemption
title_effective_datestringTitle effective date
business_partners_idjsonBusiness partner IDs
locationjsonWorker location
genderstringGender
date_of_birthstringDate of birth
racestringRace
ethnicitystringEthnicity
citizenshipstringCitizenship
termination_detailsjsonTermination details
custom_fieldsjsonCustom fields
country_fieldsjsonCountry-specific fields
__metajsonMetadata including redacted_fields

rippling_list_users

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
orderBystringNoNo description
cursorstringNoNo description

Output

ParameterTypeDescription
usersarrayList of users
idstringUser ID
created_atstringRecord creation date
updated_atstringRecord update date
activebooleanWhether the user is active
usernamestringUnique username
display_namestringDisplay name
preferred_languagestringPreferred language
localestringLocale
timezonestringTimezone (IANA format)
numberstringPermanent profile number
namejsonUser name object (given_name, family_name, etc.)
emailsjsonArray of email objects
phone_numbersjsonArray of phone number objects
addressesjsonArray of address objects
photosjsonArray of photo objects
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_get_user

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
idstringUser ID
created_atstringCreation date
updated_atstringUpdate date
activebooleanIs active
usernamestringUsername
display_namestringDisplay name
preferred_languagestringPreferred language
localestringLocale
timezonestringTimezone
numberstringProfile number
namejsonUser name object
emailsjsonEmail addresses
phone_numbersjsonPhone numbers
addressesjsonAddresses
photosjsonPhotos
__metajsonMetadata including redacted_fields

rippling_list_companies

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
expandstringNoNo description
orderBystringNoNo description
cursorstringNoNo description

Output

ParameterTypeDescription
companiesarrayList of companies
idstringCompany ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringCompany name
legal_namestringLegal name
doing_business_as_namestringDBA name
phonestringPhone number
primary_emailstringPrimary email
parent_legal_entity_idstringParent legal entity ID
legal_entities_idjsonArray of legal entity IDs
physical_addressjsonPhysical address of the holding entity
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_get_current_user

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
expandstringNoNo description

Output

ParameterTypeDescription
idstringUser ID
created_atstringCreation date
updated_atstringUpdate date
work_emailstringWork email
company_idstringCompany ID
companyjsonExpanded company object

rippling_list_entitlements

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description

Output

ParameterTypeDescription
entitlementsarrayList of entitlements
idstringEntitlement ID
descriptionstringEntitlement description
display_namestringDisplay name
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_list_departments

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
expandstringNoNo description
orderBystringNoNo description
cursorstringNoNo description

Output

ParameterTypeDescription
departmentsarrayList of departments
idstringDepartment ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringDepartment name
parent_idstringParent department ID
reference_codestringReference code
department_hierarchy_idjsonArray of department IDs in hierarchy
parentjsonExpanded parent department
department_hierarchyjsonExpanded department hierarchy
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_get_department

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description
expandstringNoNo description

Output

ParameterTypeDescription
idstringDepartment ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringDepartment name
parent_idstringParent department ID
reference_codestringReference code
department_hierarchy_idjsonArray of department IDs in hierarchy
parentjsonExpanded parent department
department_hierarchyjsonExpanded department hierarchy
__metajsonMetadata including redacted_fields

rippling_create_department

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
namestringYesNo description
parentIdstringNoNo description
referenceCodestringNoNo description

Output

ParameterTypeDescription
idstringDepartment ID
created_atstringCreation date
updated_atstringUpdate date
namestringName
parent_idstringParent department ID
reference_codestringReference code
department_hierarchy_idjsonDepartment hierarchy IDs
parentjsonExpanded parent department
department_hierarchyjsonExpanded department hierarchy

rippling_update_department

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description
namestringNoNo description
parentIdstringNoNo description
referenceCodestringNoNo description

Output

ParameterTypeDescription
idstringid output from the tool
created_atstringCreation date
updated_atstringUpdate date
namestringName
parent_idstringParent department ID
reference_codestringReference code
department_hierarchy_idjsonDepartment hierarchy IDs
parentjsonExpanded parent department
department_hierarchyjsonExpanded department hierarchy

rippling_list_teams

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
expandstringNoNo description
orderBystringNoNo description
cursorstringNoNo description

Output

ParameterTypeDescription
teamsarrayList of teams
idstringTeam ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringTeam name
parent_idstringParent team ID
parentjsonExpanded parent team
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_get_team

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description
expandstringNoNo description

Output

ParameterTypeDescription
idstringTeam ID
created_atstringCreation date
updated_atstringUpdate date
namestringName
parent_idstringParent team ID
parentjsonExpanded parent team
__metajsonMetadata including redacted_fields

rippling_list_employment_types

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
orderBystringNoNo description
cursorstringNoNo description

Output

ParameterTypeDescription
employmentTypesarrayList of employmentTypes
idstringEmployment type ID
created_atstringRecord creation date
updated_atstringRecord update date
labelstringEmployment type label
namestringEmployment type name
typestringType (CONTRACTOR, EMPLOYEE)
compensation_time_periodstringCompensation period (HOURLY, SALARIED)
amount_workedstringAmount worked (PART-TIME, FULL-TIME, TEMPORARY)
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_get_employment_type

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
idstringEmployment type ID
created_atstringCreation date
updated_atstringUpdate date
labelstringLabel
namestringName
typestringType (CONTRACTOR, EMPLOYEE)
compensation_time_periodstringCompensation period (HOURLY, SALARIED)
amount_workedstringAmount worked (PART-TIME, FULL-TIME, TEMPORARY)
__metajsonMetadata including redacted_fields

rippling_list_titles

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
orderBystringNoNo description
cursorstringNoNo description

Output

ParameterTypeDescription
titlesarrayList of titles
idstringTitle ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringTitle name
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_get_title

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
idstringTitle ID
created_atstringCreation date
updated_atstringUpdate date
namestringTitle name
__metajsonMetadata including redacted_fields

rippling_create_title

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
namestringYesNo description

Output

ParameterTypeDescription
idstringTitle ID
created_atstringCreation date
updated_atstringUpdate date
namestringname output from the tool

rippling_update_title

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description
namestringNoNo description

Output

ParameterTypeDescription
idstringid output from the tool
created_atstringCreation date
updated_atstringUpdate date
namestringname output from the tool

rippling_delete_title

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
deletedbooleanWhether the resource was deleted

rippling_list_custom_fields

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
orderBystringNoNo description
cursorstringNoNo description

Output

ParameterTypeDescription
customFieldsarrayList of customFields
idstringCustom field ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringField name
descriptionstringField description
requiredbooleanWhether the field is required
typestringField type (TEXT, DATE, NUMBER, CURRENCY, etc.)
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_list_job_functions

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
orderBystringNoNo description
cursorstringNoNo description

Output

ParameterTypeDescription
jobFunctionsarrayList of jobFunctions
idstringJob function ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringJob function name
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_get_job_function

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
idstringJob function ID
created_atstringCreation date
updated_atstringUpdate date
namestringName
__metajsonMetadata including redacted_fields

rippling_list_work_locations

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
orderBystringNoNo description
cursorstringNoNo description

Output

ParameterTypeDescription
workLocationsarrayList of workLocations
idstringWork location ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringLocation name
addressjsonAddress object
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_get_work_location

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
idstringLocation ID
created_atstringCreation date
updated_atstringUpdate date
namestringName
addressjsonAddress object
__metajsonMetadata including redacted_fields

rippling_create_work_location

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
namestringYesNo description
streetAddressstringYesNo description
localitystringNoNo description
regionstringNoNo description
postalCodestringNoNo description
countrystringNoNo description
addressTypestringNoNo description

Output

ParameterTypeDescription
idstringLocation ID
created_atstringCreated timestamp
updated_atstringUpdated timestamp
namestringName
addressjsonAddress

rippling_update_work_location

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description
namestringNoNo description
streetAddressstringNoNo description
localitystringNoNo description
regionstringNoNo description
postalCodestringNoNo description
countrystringNoNo description
addressTypestringNoNo description

Output

ParameterTypeDescription
idstringid output from the tool
created_atstringCreated timestamp
updated_atstringUpdated timestamp
namestringName
addressjsonAddress

rippling_delete_work_location

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
deletedbooleanWhether the resource was deleted

rippling_list_business_partners

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
filterstringNoNo description
expandstringNoNo description
orderBystringNoNo description
cursorstringNoNo description

Output

ParameterTypeDescription
businessPartnersarrayList of businessPartners
idstringBusiness partner ID
created_atstringRecord creation date
updated_atstringRecord update date
business_partner_group_idstringBusiness partner group ID
worker_idstringWorker ID
client_group_idstringClient group ID
client_group_member_countnumberClient group member count
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_get_business_partner

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description
expandstringNoNo description

Output

ParameterTypeDescription
idstringID
created_atstringCreation date
updated_atstringUpdate date
business_partner_group_idstringGroup ID
worker_idstringWorker ID
client_group_idstringClient group ID
client_group_member_countnumberClient group member count
__metajsonMetadata including redacted_fields

rippling_create_business_partner

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
businessPartnerGroupIdstringYesNo description
workerIdstringYesNo description

Output

ParameterTypeDescription
idstringID
created_atstringCreation date
updated_atstringUpdate date
business_partner_group_idstringGroup ID
worker_idstringWorker ID
client_group_idstringClient group ID
client_group_member_countnumberClient group member count

rippling_delete_business_partner

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
deletedbooleanWhether the resource was deleted

rippling_list_business_partner_groups

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
expandstringNoNo description
orderBystringNoNo description
cursorstringNoNo description

Output

ParameterTypeDescription
businessPartnerGroupsarrayList of businessPartnerGroups
idstringBusiness partner group ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringGroup name
domainstringDomain (HR, IT, FINANCE, RECRUITING, OTHER)
default_business_partner_idstringDefault business partner ID
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_get_business_partner_group

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description
expandstringNoNo description

Output

ParameterTypeDescription
idstringID
created_atstringCreation date
updated_atstringUpdate date
namestringName
domainstringDomain
default_business_partner_idstringDefault partner ID
__metajsonMetadata including redacted_fields

rippling_create_business_partner_group

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
namestringYesNo description
domainstringNoNo description
defaultBusinessPartnerIdstringNoNo description

Output

ParameterTypeDescription
idstringID
created_atstringCreation date
updated_atstringUpdate date
namestringName
domainstringDomain
default_business_partner_idstringDefault partner ID

rippling_delete_business_partner_group

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
deletedbooleanWhether the resource was deleted

rippling_list_supergroups

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
filterstringNoNo description
orderBystringNoNo description

Output

ParameterTypeDescription
supergroupsarrayList of supergroups
idstringSupergroup ID
created_atstringRecord creation date
updated_atstringRecord update date
display_namestringDisplay name
descriptionstringDescription
app_owner_idstringApp owner ID
group_typestringGroup type
namestringName
sub_group_typestringSub group type
read_onlybooleanWhether the group is read only
parentstringParent group ID
mutually_exclusive_keystringMutually exclusive key
cumulatively_exhaustive_defaultbooleanWhether the group is the cumulatively exhaustive default
include_terminatedbooleanWhether the group includes terminated roles
allow_non_employeesbooleanWhether the group allows non-employees
can_override_role_statesbooleanWhether the group can override role states
prioritynumberGroup priority
is_invisiblebooleanWhether the group is invisible
ignore_prov_group_matchingbooleanWhether to ignore provisioning group matching
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_get_supergroup

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
idstringSupergroup ID
created_atstringRecord creation date
updated_atstringRecord update date
display_namestringDisplay name
descriptionstringDescription
app_owner_idstringApp owner ID
group_typestringGroup type
namestringName
sub_group_typestringSub group type
read_onlybooleanWhether the group is read only
parentstringParent group ID
mutually_exclusive_keystringMutually exclusive key
cumulatively_exhaustive_defaultbooleanWhether the group is the cumulatively exhaustive default
include_terminatedbooleanWhether the group includes terminated roles
allow_non_employeesbooleanWhether the group allows non-employees
can_override_role_statesbooleanWhether the group can override role states
prioritynumberGroup priority
is_invisiblebooleanWhether the group is invisible
ignore_prov_group_matchingbooleanWhether to ignore provisioning group matching
__metajsonMetadata including redacted_fields

rippling_list_supergroup_members

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
groupIdstringYesNo description
expandstringNoNo description
orderBystringNoNo description

Output

ParameterTypeDescription
membersarrayList of members
idstringMember ID
created_atstringRecord creation date
updated_atstringRecord update date
full_namestringFull name
work_emailstringWork email
worker_idstringWorker ID
workerjsonExpanded worker object
totalCountnumberNumber of members returned
nextLinkstringNext page link
__metajsonMetadata including redacted_fields

rippling_list_supergroup_inclusion_members

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
groupIdstringYesNo description
expandstringNoNo description
orderBystringNoNo description

Output

ParameterTypeDescription
membersarrayList of members
idstringMember ID
created_atstringRecord creation date
updated_atstringRecord update date
full_namestringFull name
work_emailstringWork email
worker_idstringWorker ID
workerjsonExpanded worker object
totalCountnumberNumber of members returned
nextLinkstringNext page link
__metajsonMetadata including redacted_fields

rippling_list_supergroup_exclusion_members

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
groupIdstringYesNo description
expandstringNoNo description
orderBystringNoNo description

Output

ParameterTypeDescription
membersarrayList of members
idstringMember ID
created_atstringRecord creation date
updated_atstringRecord update date
full_namestringFull name
work_emailstringWork email
worker_idstringWorker ID
workerjsonExpanded worker object
totalCountnumberNumber of members returned
nextLinkstringNext page link
__metajsonMetadata including redacted_fields

rippling_update_supergroup_inclusion_members

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
groupIdstringYesNo description
operationsjsonYesOperations array [{op: "add"|"remove", value: [{id: "member_id"}]}]

Output

ParameterTypeDescription
okbooleanWhether the operation succeeded

rippling_update_supergroup_exclusion_members

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
groupIdstringYesNo description
operationsjsonYesOperations array [{op: "add"|"remove", value: [{id: "member_id"}]}]

Output

ParameterTypeDescription
okbooleanWhether the operation succeeded

rippling_list_custom_objects

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description

Output

ParameterTypeDescription
customObjectsarrayList of customObjects
idstringCustom object ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringObject name
descriptionstringDescription
api_namestringAPI name
plural_labelstringPlural label
category_idstringCategory ID
native_category_idstringNative category ID
managed_package_install_idstringPackage install ID
owner_idstringOwner ID
enable_historybooleanWhether history is enabled
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results

rippling_get_custom_object

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description

Output

ParameterTypeDescription
idstringID
created_atstringCreation date
updated_atstringUpdate date
namestringName
descriptionstringDescription
api_namestringAPI name
plural_labelstringPlural label
category_idstringCategory ID
enable_historybooleanHistory enabled
native_category_idstringNative category ID
managed_package_install_idstringPackage install ID
owner_idstringOwner ID

rippling_create_custom_object

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
namestringYesNo description
descriptionstringNoNo description
categorystringNoNo description

Output

ParameterTypeDescription
idstringID
created_atstringCreation date
updated_atstringUpdate date
namestringName
descriptionstringdescription output from the tool
api_namestringAPI name
plural_labelstringPlural label
category_idstringCategory ID
enable_historybooleanHistory enabled
native_category_idstringNative category ID
managed_package_install_idstringPackage install ID
owner_idstringOwner ID

rippling_update_custom_object

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description
namestringNoNo description
descriptionstringNoNo description
categorystringNoNo description
pluralLabelstringNoNo description
ownerRolestringNoNo description

Output

ParameterTypeDescription
idstringID
created_atstringCreation date
updated_atstringUpdate date
namestringname output from the tool
descriptionstringdescription output from the tool
api_namestringAPI name
plural_labelstringPlural label
category_idstringCategory ID
enable_historybooleanHistory enabled
native_category_idstringNative category ID
managed_package_install_idstringPackage install ID
owner_idstringOwner ID

rippling_delete_custom_object

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description

Output

ParameterTypeDescription
deletedbooleanWhether the resource was deleted

rippling_list_custom_object_fields

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description

Output

ParameterTypeDescription
fieldsarrayList of fields
idstringField ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringField name
custom_objectstringParent custom object
descriptionstringDescription
api_namestringAPI name
data_typejsonData type configuration
is_uniquebooleanWhether the field is unique
is_immutablebooleanWhether the field is immutable
is_standardbooleanWhether the field is standard
enable_historybooleanWhether history is enabled
managed_package_install_idstringPackage install ID
totalCountnumberNumber of fields returned
nextLinkstringNext page link

rippling_get_custom_object_field

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description
fieldApiNamestringYesNo description

Output

ParameterTypeDescription
idstringField ID
created_atstringCreation date
updated_atstringUpdate date
namestringName
custom_objectstringCustom object
descriptionstringDescription
api_namestringAPI name
data_typejsonData type configuration
is_uniquebooleanIs unique
is_immutablebooleanIs immutable
is_standardbooleanIs standard
enable_historybooleanHistory enabled
managed_package_install_idstringPackage install ID

rippling_create_custom_object_field

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description
namestringYesNo description
descriptionstringNoNo description
dataTypejsonYesNo description
requiredbooleanNoNo description
rqlDefinitionjsonNoNo description
isUniquebooleanNoNo description
formulaAttrMetasjsonNoNo description
sectionjsonNoNo description
enableHistorybooleanNoNo description
derivedFieldFormulastringNoNo description
derivedAggregatedFieldjsonNoNo description

Output

ParameterTypeDescription
idstringField ID
created_atstringCreation date
updated_atstringUpdate date
namestringName
custom_objectstringCustom object
descriptionstringdescription output from the tool
api_namestringAPI name
data_typejsonData type configuration
is_uniquebooleanIs unique
is_immutablebooleanIs immutable
is_standardbooleanIs standard
enable_historybooleanHistory enabled
managed_package_install_idstringPackage install ID

rippling_update_custom_object_field

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description
fieldApiNamestringYesNo description
namestringNoNo description
descriptionstringNoNo description
dataTypejsonNoNo description
requiredbooleanNoNo description
rqlDefinitionjsonNoNo description
isUniquebooleanNoNo description
formulaAttrMetasjsonNoNo description
sectionjsonNoNo description
enableHistorybooleanNoNo description
derivedFieldFormulastringNoNo description
nameFieldDetailsjsonNoNo description

Output

ParameterTypeDescription
idstringField ID
created_atstringCreation date
updated_atstringUpdate date
namestringName
custom_objectstringCustom object
descriptionstringdescription output from the tool
api_namestringAPI name
data_typejsonData type configuration
is_uniquebooleanIs unique
is_immutablebooleanIs immutable
is_standardbooleanIs standard
enable_historybooleanHistory enabled
managed_package_install_idstringPackage install ID

rippling_delete_custom_object_field

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description
fieldApiNamestringYesNo description

Output

ParameterTypeDescription
deletedbooleanWhether the field was deleted

rippling_list_custom_object_records

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description

Output

ParameterTypeDescription
recordsarrayList of records
idstringRecord ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringRecord name
external_idstringExternal ID
created_byjsonCreated by user (id, display_value, image)
last_modified_byjsonLast modified by user (id, display_value, image)
owner_rolejsonOwner role (id, display_value, image)
system_updated_atstringSystem update timestamp
datajsonFull record data including dynamic fields
totalCountnumberNumber of records returned
nextLinkstringNext page link

rippling_get_custom_object_record

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description
codrIdstringYesNo description

Output

ParameterTypeDescription
idstringRecord ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringRecord name
external_idstringExternal ID
created_byjsonCreated by user (id, display_value, image)
last_modified_byjsonLast modified by user (id, display_value, image)
owner_rolejsonOwner role (id, display_value, image)
system_updated_atstringSystem update timestamp
datajsonFull record data

rippling_get_custom_object_record_by_external_id

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description
externalIdstringYesNo description

Output

ParameterTypeDescription
idstringRecord ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringRecord name
external_idstringExternal ID
created_byjsonCreated by user (id, display_value, image)
last_modified_byjsonLast modified by user (id, display_value, image)
owner_rolejsonOwner role (id, display_value, image)
system_updated_atstringSystem update timestamp
datajsonFull record data

rippling_query_custom_object_records

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description
querystringNoNo description
limitnumberNoNo description
cursorstringNoNo description

Output

ParameterTypeDescription
recordsarrayMatching records
idstringRecord ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringRecord name
external_idstringExternal ID
created_byjsonCreated by user (id, display_value, image)
last_modified_byjsonLast modified by user (id, display_value, image)
owner_rolejsonOwner role (id, display_value, image)
system_updated_atstringSystem update timestamp
datajsonFull record data
totalCountnumberNumber of records returned
cursorstringCursor for next page of results

rippling_create_custom_object_record

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description
externalIdstringNoNo description
datajsonYesNo description

Output

ParameterTypeDescription
idstringRecord ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringRecord name
external_idstringExternal ID
created_byjsonCreated by user (id, display_value, image)
last_modified_byjsonLast modified by user (id, display_value, image)
owner_rolejsonOwner role (id, display_value, image)
system_updated_atstringSystem update timestamp
datajsonFull record data

rippling_update_custom_object_record

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description
codrIdstringYesNo description
externalIdstringNoNo description
datajsonNoNo description

Output

ParameterTypeDescription
idstringRecord ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringRecord name
external_idstringExternal ID
created_byjsonCreated by user (id, display_value, image)
last_modified_byjsonLast modified by user (id, display_value, image)
owner_rolejsonOwner role (id, display_value, image)
system_updated_atstringSystem update timestamp
datajsonFull record data

rippling_delete_custom_object_record

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description
codrIdstringYesNo description

Output

ParameterTypeDescription
deletedbooleanWhether the record was deleted

rippling_bulk_create_custom_object_records

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description
rowsToWritejsonYesNo description
allOrNothingbooleanNoNo description

Output

ParameterTypeDescription
createdRecordsarrayCreated custom object records
totalCountnumberNumber of records created

rippling_bulk_update_custom_object_records

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description
rowsToUpdatejsonYesNo description
allOrNothingbooleanNoNo description

Output

ParameterTypeDescription
updatedRecordsarrayUpdated custom object records
totalCountnumberNumber of records updated

rippling_bulk_delete_custom_object_records

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
customObjectApiNamestringYesNo description
rowsToDeletejsonYesNo description
allOrNothingbooleanNoNo description

Output

ParameterTypeDescription
deletedbooleanWhether the bulk delete succeeded

rippling_list_custom_apps

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description

Output

ParameterTypeDescription
customAppsarrayList of customApps
idstringApp ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringApp name
api_namestringAPI name
descriptionstringDescription
iconstringIcon URL
pagesjsonArray of page summaries
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_get_custom_app

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
idstringApp ID
created_atstringCreation date
updated_atstringUpdate date
namestringName
api_namestringAPI name
descriptionstringDescription
iconstringIcon URL
pagesjsonArray of page summaries
__metajsonMetadata including redacted_fields

rippling_create_custom_app

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
namestringYesNo description
apiNamestringYesNo description
descriptionstringNoNo description

Output

ParameterTypeDescription
idstringApp ID
created_atstringCreation date
updated_atstringUpdate date
namestringName
api_namestringAPI name
descriptionstringdescription output from the tool
iconstringIcon URL
pagesjsonArray of page summaries

rippling_update_custom_app

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description
namestringNoNo description
apiNamestringNoNo description
descriptionstringNoNo description

Output

ParameterTypeDescription
idstringid output from the tool
created_atstringCreation date
updated_atstringUpdate date
namestringName
api_namestringAPI name
descriptionstringdescription output from the tool
iconstringIcon URL
pagesjsonArray of page summaries

rippling_delete_custom_app

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
deletedbooleanWhether the resource was deleted

rippling_list_custom_pages

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description

Output

ParameterTypeDescription
customPagesarrayList of customPages
idstringPage ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringPage name
componentsjsonPage components
actionsjsonPage actions
canvas_actionsjsonCanvas actions
variablesjsonPage variables
mediajsonPage media
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_get_custom_page

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
idstringPage ID
created_atstringCreation date
updated_atstringUpdate date
namestringName
componentsjsonPage components
actionsjsonPage actions
canvas_actionsjsonCanvas actions
variablesjsonPage variables
mediajsonPage media
__metajsonMetadata including redacted_fields

rippling_create_custom_page

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
namestringYesNo description

Output

ParameterTypeDescription
idstringPage ID
created_atstringCreation date
updated_atstringUpdate date
namestringName
componentsjsonPage components
actionsjsonPage actions
canvas_actionsjsonCanvas actions
variablesjsonPage variables
mediajsonPage media

rippling_update_custom_page

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description
namestringNoNo description

Output

ParameterTypeDescription
idstringid output from the tool
created_atstringCreation date
updated_atstringUpdate date
namestringName
componentsjsonPage components
actionsjsonPage actions
canvas_actionsjsonCanvas actions
variablesjsonPage variables
mediajsonPage media

rippling_delete_custom_page

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
deletedbooleanWhether the resource was deleted

rippling_list_custom_settings

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
orderBystringNoNo description
cursorstringNoNo description

Output

ParameterTypeDescription
customSettingsarrayList of custom settings
idstringSetting ID
created_atstringRecord creation date
updated_atstringRecord update date
display_namestringDisplay name
api_namestringAPI name
data_typestringData type
secret_valuestringSecret value
string_valuestringString value
number_valuenumberNumber value
boolean_valuebooleanBoolean value
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results
__metajsonMetadata including redacted_fields

rippling_get_custom_setting

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
idstringSetting ID
created_atstringRecord creation date
updated_atstringRecord update date
display_namestringDisplay name
api_namestringAPI name
data_typestringData type
secret_valuestringSecret value
string_valuestringString value
number_valuenumberNumber value
boolean_valuebooleanBoolean value
__metajsonMetadata including redacted_fields

rippling_create_custom_setting

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
displayNamestringNoNo description
apiNamestringNoNo description
dataTypestringNoNo description
secretValuestringNoNo description
stringValuestringNoNo description
numberValuenumberNoNo description
booleanValuebooleanNoNo description

Output

ParameterTypeDescription
idstringSetting ID
created_atstringRecord creation date
updated_atstringRecord update date
display_namestringDisplay name
api_namestringAPI name
data_typestringData type
secret_valuestringSecret value
string_valuestringString value
number_valuenumberNumber value
boolean_valuebooleanBoolean value

rippling_update_custom_setting

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description
displayNamestringNoNo description
apiNamestringNoNo description
dataTypestringNoNo description
secretValuestringNoNo description
stringValuestringNoNo description
numberValuenumberNoNo description
booleanValuebooleanNoNo description

Output

ParameterTypeDescription
idstringSetting ID
created_atstringRecord creation date
updated_atstringRecord update date
display_namestringDisplay name
api_namestringAPI name
data_typestringData type
secret_valuestringSecret value
string_valuestringString value
number_valuenumberNumber value
boolean_valuebooleanBoolean value

rippling_delete_custom_setting

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
deletedbooleanWhether the resource was deleted

rippling_list_object_categories

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description

Output

ParameterTypeDescription
objectCategoriesarrayList of objectCategories
idstringCategory ID
created_atstringRecord creation date
updated_atstringRecord update date
namestringCategory name
descriptionstringDescription
totalCountnumberNumber of items returned
nextLinkstringLink to next page of results

rippling_get_object_category

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
idstringCategory ID
created_atstringCreation date
updated_atstringUpdate date
namestringName
descriptionstringDescription

rippling_create_object_category

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
namestringYesNo description
descriptionstringNoNo description

Output

ParameterTypeDescription
idstringCategory ID
created_atstringCreation date
updated_atstringUpdate date
namestringName
descriptionstringdescription output from the tool

rippling_update_object_category

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description
namestringNoNo description
descriptionstringNoNo description

Output

ParameterTypeDescription
idstringid output from the tool
created_atstringCreation date
updated_atstringUpdate date
namestringName
descriptionstringdescription output from the tool

rippling_delete_object_category

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
idstringYesNo description

Output

ParameterTypeDescription
deletedbooleanWhether the resource was deleted

rippling_get_report_run

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
runIdstringYesNo description

Output

ParameterTypeDescription
idstringReport run ID
report_idstringReport ID
statusstringRun status
file_urlstringURL to download the report file
expires_atstringExpiration timestamp for the file URL
output_typestringOutput format (JSON or CSV)
__metajsonMetadata including redacted_fields

rippling_trigger_report_run

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
reportIdstringYesNo description
includeObjectIdsbooleanNoNo description
includeTotalRowsbooleanNoNo description
formatDateFieldsjsonNoNo description
formatCurrencyFieldsjsonNoNo description
outputTypestringNoNo description

Output

ParameterTypeDescription
idstringReport run ID
report_idstringReport ID
statusstringRun status
file_urlstringURL to download the report file
expires_atstringExpiration timestamp for the file URL
output_typestringOutput format (JSON or CSV)

rippling_create_draft_hires

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
draftHiresjsonYesNo description

Output

ParameterTypeDescription
invalidItemsjsonFailed draft hires
successfulResultsjsonSuccessful draft hires
totalInvalidnumberNumber of failures
totalSuccessfulnumberNumber of successes

On this page

Usage Instructions
Tools
rippling_list_workers
Input
Output
rippling_get_worker
Input
Output
rippling_list_users
Input
Output
rippling_get_user
Input
Output
rippling_list_companies
Input
Output
rippling_get_current_user
Input
Output
rippling_list_entitlements
Input
Output
rippling_list_departments
Input
Output
rippling_get_department
Input
Output
rippling_create_department
Input
Output
rippling_update_department
Input
Output
rippling_list_teams
Input
Output
rippling_get_team
Input
Output
rippling_list_employment_types
Input
Output
rippling_get_employment_type
Input
Output
rippling_list_titles
Input
Output
rippling_get_title
Input
Output
rippling_create_title
Input
Output
rippling_update_title
Input
Output
rippling_delete_title
Input
Output
rippling_list_custom_fields
Input
Output
rippling_list_job_functions
Input
Output
rippling_get_job_function
Input
Output
rippling_list_work_locations
Input
Output
rippling_get_work_location
Input
Output
rippling_create_work_location
Input
Output
rippling_update_work_location
Input
Output
rippling_delete_work_location
Input
Output
rippling_list_business_partners
Input
Output
rippling_get_business_partner
Input
Output
rippling_create_business_partner
Input
Output
rippling_delete_business_partner
Input
Output
rippling_list_business_partner_groups
Input
Output
rippling_get_business_partner_group
Input
Output
rippling_create_business_partner_group
Input
Output
rippling_delete_business_partner_group
Input
Output
rippling_list_supergroups
Input
Output
rippling_get_supergroup
Input
Output
rippling_list_supergroup_members
Input
Output
rippling_list_supergroup_inclusion_members
Input
Output
rippling_list_supergroup_exclusion_members
Input
Output
rippling_update_supergroup_inclusion_members
Input
Output
rippling_update_supergroup_exclusion_members
Input
Output
rippling_list_custom_objects
Input
Output
rippling_get_custom_object
Input
Output
rippling_create_custom_object
Input
Output
rippling_update_custom_object
Input
Output
rippling_delete_custom_object
Input
Output
rippling_list_custom_object_fields
Input
Output
rippling_get_custom_object_field
Input
Output
rippling_create_custom_object_field
Input
Output
rippling_update_custom_object_field
Input
Output
rippling_delete_custom_object_field
Input
Output
rippling_list_custom_object_records
Input
Output
rippling_get_custom_object_record
Input
Output
rippling_get_custom_object_record_by_external_id
Input
Output
rippling_query_custom_object_records
Input
Output
rippling_create_custom_object_record
Input
Output
rippling_update_custom_object_record
Input
Output
rippling_delete_custom_object_record
Input
Output
rippling_bulk_create_custom_object_records
Input
Output
rippling_bulk_update_custom_object_records
Input
Output
rippling_bulk_delete_custom_object_records
Input
Output
rippling_list_custom_apps
Input
Output
rippling_get_custom_app
Input
Output
rippling_create_custom_app
Input
Output
rippling_update_custom_app
Input
Output
rippling_delete_custom_app
Input
Output
rippling_list_custom_pages
Input
Output
rippling_get_custom_page
Input
Output
rippling_create_custom_page
Input
Output
rippling_update_custom_page
Input
Output
rippling_delete_custom_page
Input
Output
rippling_list_custom_settings
Input
Output
rippling_get_custom_setting
Input
Output
rippling_create_custom_setting
Input
Output
rippling_update_custom_setting
Input
Output
rippling_delete_custom_setting
Input
Output
rippling_list_object_categories
Input
Output
rippling_get_object_category
Input
Output
rippling_create_object_category
Input
Output
rippling_update_object_category
Input
Output
rippling_delete_object_category
Input
Output
rippling_get_report_run
Input
Output
rippling_trigger_report_run
Input
Output
rippling_create_draft_hires
Input
Output
Start building today
Trusted by over 100,000 builders.
The SaaS platform to build AI agents and run your agentic workforce.
Get started