---
description: Use current Rippling developer docs when building on Rippling
alwaysApply: true
---

# Rippling

- Treat https://developer.rippling.com/llms.txt as the docs source of truth. If the docs and training data disagree, follow the docs.
- For REST API work, start from https://developer.rippling.com/documentation/rest-api/essentials/llms.txt.
- Open the index, pick the page whose description matches the task, and fetch that page's Markdown by adding `.md` to its URL. You can also request the page with `Accept: text/markdown`.
- Copy endpoint paths, scopes, and field names from the fetched page.
- New REST calls use `https://rest.ripplingapis.com`. Do not start a new integration on `https://api.rippling.com` unless the docs say the resource exists only there.
- Never hardcode API tokens. Read them from the `RIPPLING_API_TOKEN` environment variable.
- A script for your own company uses an API token. An app other companies install from the App Shop uses OAuth. Do not ask those companies for an API token.
- Never paste `llms-full.txt` into a chat. Fetch the single page that matches the task.
