---
title: "Rippling"
description: "Synchroniseer medewerkers uit Rippling door in te loggen of met een API-sleutel, kies de gerelateerde gegevens om uit te breiden, en koppel zo nodig opnieuw met een nieuwe sleutel."
sidebar:
  label: Overzicht
  order: 0
area: integrations
feature: rippling
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-09"
audience: admin
related:
  - integrations
  - integrations/hris-fields
  - integrations/sync-and-matching
  - directory/employees
translation:
  source: integrations/rippling/index.mdx
  sourceSha: 53003e676cf6adaf8084fa890f830e37d20ba3c9
---

De Rippling-integratie leest workers via de API van Rippling en houdt de Directory actueel: namen, zakelijk en persoonlijk e-mailadres, startdatum en datum uit dienst, functietitel, afdeling, manager, type dienstverband en type werknemer. Pyn leest alleen; er wordt niets teruggeschreven.

## Voordat je begint

- Je bent admin of owner in Pyn; **Connect** en **Reconnect** zijn voor andere rollen uitgeschakeld.
- Ofwel kun je als beheerder inloggen bij Rippling en Pyn autoriseren, ofwel heeft een Rippling-beheerder een **API key** voor Pyn aangemaakt.

![Connect to Rippling redirects you to Rippling, or takes an API key instead.](https://support.pyn.ai/media/integrations/rippling/integrations-rippling-connect.png)

## Koppelen

1. Open in Pyn **Settings** in de linkernavigatie, en dan **Available** onder **Integrations**.

2. Selecteer de tegel **Rippling**. Het dialoogvenster **Connect to Rippling** opent: "You will be redirected to Rippling to authorize Pyn to access your company's employee data."

3. Om in te loggen laat je **API Key (optional)** leeg en selecteer je **Connect**. Autoriseer Pyn in Rippling en keer terug.

4. Om in plaats daarvan een sleutel te gebruiken, plak je die in **API Key (optional)** ("Connect with a Rippling API key instead") en selecteer je **Connect**.

5. Het paneel leest "You're connected. Syncing can take a few minutes. Check the journey map then!"

## Wat er wordt gesynchroniseerd

Pyn ververst ongeveer één keer per uur vanuit Rippling en legt elke run vast onder **History**. Het tabblad **Details** toont **Expanded Data**, de gerelateerde records die Pyn bij elke worker opvraagt: **Department**, **Employment Type**, **Manager** en **Teams**; je kunt de selectie daar wijzigen.

| Eigenschap in Pyn | Uit Rippling |
| --- | --- |
| Weergavenaam, officiële naam, roepnaam | De namen van de worker |
| Zakelijk e-mailadres, persoonlijk e-mailadres | Zakelijk en privé-e-mailadres, met de e-mailadressen van de gebruiker als terugval |
| Startdatum, diensttijddatum | Startdatum (de diensttijd volgt die) |
| Datum uit dienst | Datum uit dienst of einddatum |
| Functietitel, afdeling, locatie | Functietitel, afdelingsnaam en werklocatie |
| Type medewerker, type dienstverband, type werknemer, type werktijd, exempt | Type dienstverband en classificatie |
| Manager | Manager, wanneer **Manager** is uitgebreid |
| Avatar, verjaardag, land, postcode, tijdzone | Profielfoto en adres; tijdzone uit de eigen tijdzone van de Rippling-gebruiker, anders uit land en postcode |

Zie [HRIS-velden](https://support.pyn.ai/nl/integrations/hris-fields/) voor de matrix.

## Testen

Open de tegel Rippling onder **Installed**, open het menu **...** en selecteer **Test Connection**. "Successfully tested the connection to Rippling." bevestigt het; "An error occurred connecting to Rippling. Please Reconnect or contact support if the issue persists." betekent dat de inloggegevens niet meer werken. Controleer daarna [Employees](https://support.pyn.ai/nl/directory/employees/).

## Opnieuw koppelen of ontkoppelen

- **Reconnect** opent **Reconnect to Rippling**: "Enter a new Rippling API key to reconnect this integration." Plak de sleutel in **API Key** en selecteer **Reconnect**. Opnieuw koppelen gaat altijd met een sleutel; de inlogroute is voor de eerste koppeling.
- **Deactivate** stopt het synchroniseren; **Activate** hervat het. **Archive** verwijdert de integratie uit Installed. Gaat de actie niet door, dan meldt een toast **Could not deactivate the integration** of **Could not archive the integration**.

## Problemen oplossen

| Wat je ziet | Wat het betekent |
| --- | --- |
| History: "Error: Authentication failed, please reconnect" | De sleutel is ingetrokken of de autorisatie is ingetrokken. Koppel opnieuw met een nieuwe sleutel. |
| History: "Error: Insufficient permissions to access Rippling" | De sleutel kan geen workers of een van de uitgebreide records lezen. Verruim zijn scopes in Rippling. |
| History: "Could not connect to Rippling, please reconnect" | Rippling heeft de verbinding geweigerd; koppel opnieuw, en neem contact op met support als het zich herhaalt. |
| Managers ontbreken | **Manager** staat niet in **Expanded Data**. Vink het aan op het tabblad Details. |

## Gerelateerd

- [Integrations](https://support.pyn.ai/nl/integrations/) voor de catalogus.
- [HRIS-velden](https://support.pyn.ai/nl/integrations/hris-fields/) voor de veldenmatrix.
- [Synchronisatiefrequentie en matching](https://support.pyn.ai/nl/integrations/sync-and-matching/) voor schema's en matching.
- [Employees](https://support.pyn.ai/nl/directory/employees/) om de gesynchroniseerde records te controleren.
