feat(rippling): expand Rippling integration from to 86 tools, landing updates by waleedlatif1 · Pull Request #3886 · simstudioai/sim

waleedlatif1 · 2026-04-01T21:25:03Z

Summary

Replaced 16 legacy Rippling tools with 86 tools covering the full Rippling Platform API
Added tools for: workers, users, companies, departments, titles, work locations, business partners, custom objects/fields/records, custom apps/pages/settings, supergroups, entitlements, employment types, job functions, reports, draft hires, object categories
Rewrote the block definition with proper conditional subBlocks, advanced mode for pagination/filters, and spreadOps pattern for param mapping
Updated docs, integrations JSON, and icon color
Removed all legacy/deprecated tool files

Type of Change

New feature

Testing

Validated against OpenAPI spec across multiple rounds with parallel agents. TypeScript compiles clean.

Checklist

Code follows project style guidelines
Self-reviewed my changes
Tests added/updated and passing
No new warnings introduced
I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

vercel · 2026-04-01T21:25:10Z

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs	Skipped		Apr 2, 2026 8:27am

cursor · 2026-04-01T21:25:11Z

PR Summary

Medium Risk
Mostly documentation/metadata and marketing UI changes, but the Rippling surface area expands significantly (19→86 operations) and the landing preview adds new interactive views, increasing the chance of mismatches or UI regressions.

Overview
Expands the Rippling integration surface from 19 to 86 documented operations by rewriting docs/en/tools/rippling.mdx and updating integrations.json to reflect the full Platform REST API (workers/users/companies, org objects, custom objects/apps/pages/settings, supergroups, reports, draft hires, etc.).

Updates landing/SEO messaging and previews: adds a multi-view interactive landing workspace preview (Tables/Files/Knowledge/Logs/Scheduled Tasks) with clickable sidebar nav and new mock UIs/data, tweaks workflow preview chip spacing, and updates multiple pages/structured data/LLM endpoints to remove HIPAA claims (SOC2-only). Also removes the HIPAABadgeIcon, adds a FireworksIcon, adjusts Guardrails docs to drop HIPAA mentions, and makes small docs/test tweaks (Tailscale intro markers + tags optional; Gmail test fixture email).

^{Written by Cursor Bugbot for commit 07ac0ec. Configure here.}

apps/sim/blocks/blocks/rippling.ts

…r create operations

Add fields found missing by validation agents: - list_companies: physical_address - list/get_supergroups: sub_group_type, read_only, parent, mutually_exclusive_key, cumulatively_exhaustive_default, include_terminated - list/get/create/update_custom_object: native_category_id, managed_package_install_id, owner_id - list/get/create/update_custom_app: icon, pages - list/get/create/update_custom_object_field: managed_package_install_id

- Add 17 missing collection output keys (titles, workLocations, supergroups, etc.) - Add delete/bulk/report output keys (deleted, results, report_id, etc.) - Mark data subBlock required for create_business_partner, create_custom_app, and create_custom_object_field (all have required params via data JSON spread) - Add optional: true to get_current_user work_email and company_id outputs

- Add 5 missing supergroup fields (allow_non_employees, can_override_role_states, priority, is_invisible, ignore_prov_group_matching) to types, list, and get tools - Fix ok fallback from true to false in supergroup inclusion/exclusion member update tools - Fix truthy check to null check for description param in create_custom_object_field

…etting responses - Add 5 missing CustomPage fields (components, actions, canvas_actions, variables, media) to types and all page tools - Replace opaque data blob with structured field mapping in create/update custom setting transforms - Fix secret_value type cast consistency in list_custom_settings

…prove UX - Add 9 missing Worker fields (location, gender, date_of_birth, race, ethnicity, citizenship, termination_details, custom_fields, country_fields) - Add 5 missing User fields (name, emails, phone_numbers, addresses, photos) - Add worker expandable field to GroupMember types and all 3 member list tools - Add 5 optional params to trigger_report_run (includeObjectIds, includeTotalRows, formatDateFields, formatCurrencyFields, outputType) - Fix truthy checks to null checks in create_department, create/update_work_location - Fix customObjectId subBlock label to say "API Name" instead of "ID"

…docs - Replace all `if (params.x)` with `if (params.x != null)` across 30+ tool files to prevent empty string/false/zero suppression - Add expandable `parent` and `department_hierarchy` fields to department tools - Add expandable `parent` field to team tools - Add `company` expandable field to get_current_user - Add `addressType` param to create/update work location tools - Fix `secret_value` output type from 'json' to 'string' in list_custom_settings - Regenerate docs for all 86 tools from current definitions Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Add 6 advanced params to create_custom_object_field: required, rqlDefinition, formulaAttrMetas, section, derivedFieldFormula, derivedAggregatedField - Add 6 advanced params to update_custom_object_field: required, rqlDefinition, formulaAttrMetas, section, derivedFieldFormula, nameFieldDetails - Add 4 record output fields to all custom object record tools: created_by, last_modified_by, owner_role, system_updated_at - Add cursor param to get_current_user - Add __meta response field to get_report_run - Regenerate docs for all 86 tools Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Add __meta to 14 GET-by-ID tools (MetaResponse pattern) - Fix supergroup tools: add filter to list_supergroups, remove invalid cursor from 4 list endpoints, revert update members to PATCH with Operations body - Fix query_custom_object_records: use query/limit/cursor body params, return cursor instead of nextLink - Fix bulk_create: use rows_to_write per spec - Fix create/update record body wrappers with externalId support - Update types.ts param interfaces and block config mappings - Add limit param mapping with Number() conversion in block config - Regenerate docs Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

waleedlatif1 · 2026-04-02T06:57:17Z

@greptile

waleedlatif1 · 2026-04-02T06:57:23Z

@cusror review

apps/sim/lib/workflows/migrations/subblock-migrations.ts

…tion values - Remove "(JSON)" suffix from all subBlock titles - Add wandConfig with AI prompts for filter, expand, orderBy, query, data, records, and dataType fields - Add OPERATION_VALUE_MIGRATIONS to migrate old operation values (list_employees → list_workers, etc.) preventing runtime errors on saved workflows Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Fix "a object" → "an object" in update/delete object category descriptions - Revert OPERATION_VALUE_MIGRATIONS (unnecessary for low-usage integration) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Adds Tables, Files, Knowledge Base, Logs, and Scheduled Tasks preview components to the landing hero, with sidebar nav items that switch to each view.

waleedlatif1 · 2026-04-02T08:15:56Z

@greptile

waleedlatif1 · 2026-04-02T08:16:03Z

@cursor review

apps/sim/lib/workflows/migrations/subblock-migrations.ts

- Replace widthMultiplier with explicit width on PreviewColumn - Replace key={i} with key={Icon.name} in connectorIcons - Scope --c-active CSS variable to sidebar container, eliminating hardcoded #363636 duplication - Replace '- - -' fallback with em dash - Type onSelectNav as (id: SidebarView) removing the unsafe cast

waleedlatif1 · 2026-04-02T08:24:02Z

@greptile

waleedlatif1 · 2026-04-02T08:24:11Z

@cursor review

...omponents/landing-preview/components/landing-preview-knowledge/landing-preview-knowledge.tsx

…ation breakage

waleedlatif1 · 2026-04-02T08:27:46Z

@cursor review

cursor

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

… updates (#3886) * feat(rippling): expand Rippling integration from 16 to 86 tools * fix(rippling): add required constraints on name and data subBlocks for create operations * fix(rippling): add subblock ID migrations for removed legacy fields * fix(docs): add MANUAL-CONTENT markers to tailscale docs and regenerate * fix(rippling): add missing response fields to tool transforms Add fields found missing by validation agents: - list_companies: physical_address - list/get_supergroups: sub_group_type, read_only, parent, mutually_exclusive_key, cumulatively_exhaustive_default, include_terminated - list/get/create/update_custom_object: native_category_id, managed_package_install_id, owner_id - list/get/create/update_custom_app: icon, pages - list/get/create/update_custom_object_field: managed_package_install_id * fix(rippling): add missing block outputs and required data conditions - Add 17 missing collection output keys (titles, workLocations, supergroups, etc.) - Add delete/bulk/report output keys (deleted, results, report_id, etc.) - Mark data subBlock required for create_business_partner, create_custom_app, and create_custom_object_field (all have required params via data JSON spread) - Add optional: true to get_current_user work_email and company_id outputs * fix(rippling): add missing supergroup fields and fix validation issues - Add 5 missing supergroup fields (allow_non_employees, can_override_role_states, priority, is_invisible, ignore_prov_group_matching) to types, list, and get tools - Fix ok fallback from true to false in supergroup inclusion/exclusion member update tools - Fix truthy check to null check for description param in create_custom_object_field * fix(rippling): add missing custom page fields and structured custom setting responses - Add 5 missing CustomPage fields (components, actions, canvas_actions, variables, media) to types and all page tools - Replace opaque data blob with structured field mapping in create/update custom setting transforms - Fix secret_value type cast consistency in list_custom_settings * fix(rippling): add missing response fields, fix truthy checks, and improve UX - Add 9 missing Worker fields (location, gender, date_of_birth, race, ethnicity, citizenship, termination_details, custom_fields, country_fields) - Add 5 missing User fields (name, emails, phone_numbers, addresses, photos) - Add worker expandable field to GroupMember types and all 3 member list tools - Add 5 optional params to trigger_report_run (includeObjectIds, includeTotalRows, formatDateFields, formatCurrencyFields, outputType) - Fix truthy checks to null checks in create_department, create/update_work_location - Fix customObjectId subBlock label to say "API Name" instead of "ID" * update docs * fix(rippling): fix truthy checks, add missing fields, and regenerate docs - Replace all `if (params.x)` with `if (params.x != null)` across 30+ tool files to prevent empty string/false/zero suppression - Add expandable `parent` and `department_hierarchy` fields to department tools - Add expandable `parent` field to team tools - Add `company` expandable field to get_current_user - Add `addressType` param to create/update work location tools - Fix `secret_value` output type from 'json' to 'string' in list_custom_settings - Regenerate docs for all 86 tools from current definitions Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix(rippling): add all remaining spec fields and regenerate docs - Add 6 advanced params to create_custom_object_field: required, rqlDefinition, formulaAttrMetas, section, derivedFieldFormula, derivedAggregatedField - Add 6 advanced params to update_custom_object_field: required, rqlDefinition, formulaAttrMetas, section, derivedFieldFormula, nameFieldDetails - Add 4 record output fields to all custom object record tools: created_by, last_modified_by, owner_role, system_updated_at - Add cursor param to get_current_user - Add __meta response field to get_report_run - Regenerate docs for all 86 tools Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix(rippling): align all tools with OpenAPI spec - Add __meta to 14 GET-by-ID tools (MetaResponse pattern) - Fix supergroup tools: add filter to list_supergroups, remove invalid cursor from 4 list endpoints, revert update members to PATCH with Operations body - Fix query_custom_object_records: use query/limit/cursor body params, return cursor instead of nextLink - Fix bulk_create: use rows_to_write per spec - Fix create/update record body wrappers with externalId support - Update types.ts param interfaces and block config mappings - Add limit param mapping with Number() conversion in block config - Regenerate docs Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix(rippling): address PR review comments — add dedicated subBlocks, fix data duplication, expand externalId condition - Add dedicated apiName, businessPartnerGroupId, workerId, dataType subBlocks so required params are no longer hidden behind opaque data JSON - Narrow `data: item` in custom object record tools to only include dynamic fields, avoiding duplication of enumerated fields - Expand externalId subBlock condition to include create/update custom object record operations Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix(rippling): remove data JSON required for ops with dedicated subBlocks create_business_partner, create_custom_app, and create_custom_object_field now have dedicated subBlocks for their required params, so the data JSON field is supplementary (not required) for those operations. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix(rippling): use rest-destructuring for all custom object record data output The spec uses additionalProperties for custom fields at the top level, not a nested `data` sub-object. Use the same rest-destructuring pattern across all 6 custom object record tools so `data` only contains dynamic fields, not duplicates of enumerated standard fields. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix(rippling): make update_custom_object_record data param optional in type Matches the tool's `required: false` — users may update only external_id without changing data. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix(rippling): add dedicated streetAddress subBlock for create_work_location streetAddress is required by the tool but had no dedicated subBlock — users had to include it in the data JSON. Now has its own required subBlock matching the pattern used by all other required params. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix(rippling): add allOrNothing subBlock for bulk operations The bulk create/update/delete tools accept an optional allOrNothing boolean param, but it had no subBlock and no way to be passed through the block UI. Added as an advanced-mode dropdown with boolean coercion. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix(rippling): derive spreadOps from DATA_OPS to prevent divergence Replace the hardcoded spreadOps array with a derivation from the file-level DATA_OPS constant minus non-spread operations. This ensures new create/update operations added to DATA_OPS automatically get spread behavior without needing a second manual update. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * updated * fix(rippling): replace generic JSON outputs with specific fields per API spec - Extract file_url, expires_at, output_type from report run result blob - Rename bulk create/update outputs to createdRecords/updatedRecords - Fix list_custom_settings output key mismatch (settings → customSettings) - Make data optional for update_custom_object_record in block - Update block outputs to match new tool output fields Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix landing * restore FF * fix(rippling): add wandConfig, clean titles, and migrate legacy operation values - Remove "(JSON)" suffix from all subBlock titles - Add wandConfig with AI prompts for filter, expand, orderBy, query, data, records, and dataType fields - Add OPERATION_VALUE_MIGRATIONS to migrate old operation values (list_employees → list_workers, etc.) preventing runtime errors on saved workflows Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix(rippling): fix grammar typos and revert unnecessary migration - Fix "a object" → "an object" in update/delete object category descriptions - Revert OPERATION_VALUE_MIGRATIONS (unnecessary for low-usage integration) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * feat(landing): add interactive workspace preview tabs Adds Tables, Files, Knowledge Base, Logs, and Scheduled Tasks preview components to the landing hero, with sidebar nav items that switch to each view. * test updates * refactor(landing): clean up code quality issues in preview components - Replace widthMultiplier with explicit width on PreviewColumn - Replace key={i} with key={Icon.name} in connectorIcons - Scope --c-active CSS variable to sidebar container, eliminating hardcoded #363636 duplication - Replace '- - -' fallback with em dash - Type onSelectNav as (id: SidebarView) removing the unsafe cast * fix(landing): use stable index key in connectorIcons to avoid minification breakage --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

vercel bot deployed to Preview April 1, 2026 21:27 View deployment

cursor bot reviewed Apr 1, 2026

View reviewed changes

apps/sim/blocks/blocks/rippling.ts Show resolved Hide resolved

apps/sim/blocks/blocks/rippling.ts Show resolved Hide resolved

vercel bot temporarily deployed to Preview April 1, 2026 21:36 Inactive

vercel bot temporarily deployed to Preview April 1, 2026 21:51 Inactive

waleedlatif1 force-pushed the waleedlatif1/rippling-add-missing-tools branch from 759c01a to d23fe32 Compare April 1, 2026 21:53

vercel bot deployed to Preview April 1, 2026 21:56 View deployment

vercel bot deployed to Preview April 1, 2026 21:59 View deployment

vercel bot temporarily deployed to Preview April 1, 2026 22:13 Inactive

vercel bot temporarily deployed to Preview April 1, 2026 22:17 Inactive

vercel bot temporarily deployed to Preview April 1, 2026 22:24 Inactive

vercel bot temporarily deployed to Preview April 1, 2026 22:26 Inactive

vercel bot temporarily deployed to Preview April 1, 2026 22:33 Inactive

vercel bot deployed to Preview April 1, 2026 22:38 View deployment

vercel bot deployed to Preview April 2, 2026 00:32 View deployment

vercel bot deployed to Preview April 2, 2026 00:52 View deployment

waleedlatif1 and others added 13 commits April 1, 2026 18:47

feat(rippling): expand Rippling integration from 16 to 86 tools

9d03134

fix(rippling): add required constraints on name and data subBlocks fo…

bebc9a0

…r create operations

fix(rippling): add subblock ID migrations for removed legacy fields

c31c549

fix(docs): add MANUAL-CONTENT markers to tailscale docs and regenerate

a78d83f

update docs

ff46604

restore FF

aac4200

vercel bot deployed to Preview April 2, 2026 06:55 View deployment

greptile-apps bot reviewed Apr 2, 2026

View reviewed changes

apps/sim/lib/workflows/migrations/subblock-migrations.ts Show resolved Hide resolved

vercel bot temporarily deployed to Preview April 2, 2026 07:10 Inactive

fix(rippling): fix grammar typos and revert unnecessary migration

84d4128

- Fix "a object" → "an object" in update/delete object category descriptions - Revert OPERATION_VALUE_MIGRATIONS (unnecessary for low-usage integration) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

vercel bot temporarily deployed to Preview April 2, 2026 07:22 Inactive

feat(landing): add interactive workspace preview tabs

fd38f15

Adds Tables, Files, Knowledge Base, Logs, and Scheduled Tasks preview components to the landing hero, with sidebar nav items that switch to each view.

vercel bot temporarily deployed to Preview April 2, 2026 08:09 Inactive

test updates

270de9f

vercel bot temporarily deployed to Preview April 2, 2026 08:10 Inactive

cursor bot reviewed Apr 2, 2026

View reviewed changes

apps/sim/lib/workflows/migrations/subblock-migrations.ts Show resolved Hide resolved

waleedlatif1 changed the title ~~feat(rippling): expand Rippling integration from 16 to 86 tools~~ feat(rippling): expand Rippling integration from to 86 tools, landing updates Apr 2, 2026

vercel bot temporarily deployed to Preview April 2, 2026 08:20 Inactive

cursor bot reviewed Apr 2, 2026

View reviewed changes

...omponents/landing-preview/components/landing-preview-knowledge/landing-preview-knowledge.tsx Show resolved Hide resolved

fix(landing): use stable index key in connectorIcons to avoid minific…

07ac0ec

…ation breakage

vercel bot temporarily deployed to Preview April 2, 2026 08:27 Inactive

waleedlatif1 merged commit 080a0a6 into staging Apr 2, 2026
7 checks passed

waleedlatif1 deleted the waleedlatif1/rippling-add-missing-tools branch April 2, 2026 08:30

waleedlatif1 mentioned this pull request Apr 2, 2026

v0.6.20: oauth default credential name, models pages, new models #3894

Merged

cursor bot reviewed Apr 2, 2026

View reviewed changes

Conversation

waleedlatif1 commented Apr 1, 2026

Summary

Type of Change

Testing

Checklist

Uh oh!

vercel bot commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cursor bot commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Summary

Uh oh!

Uh oh!

Uh oh!

waleedlatif1 commented Apr 2, 2026

Uh oh!

waleedlatif1 commented Apr 2, 2026

Uh oh!

Uh oh!

waleedlatif1 commented Apr 2, 2026

Uh oh!

waleedlatif1 commented Apr 2, 2026

Uh oh!

Uh oh!

waleedlatif1 commented Apr 2, 2026

Uh oh!

waleedlatif1 commented Apr 2, 2026

Uh oh!

Uh oh!

waleedlatif1 commented Apr 2, 2026

Uh oh!

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

vercel bot commented Apr 1, 2026 •

edited

Loading

cursor bot commented Apr 1, 2026 •

edited

Loading