Connect Perdoo
OKRs + key results progress per employee.
Prerequisites
- Perdoo admin
- A PerfCopilot admin account (the Connect button is only visible to admins)
1. Generate credentials in Perdoo
- Sign in to https://app.perdoo.com.
- Open Settings → API.
📖 Official guide: API — Perdoo's own documentation for creating this credential.
- Click Generate to create a personal API key.
- Copy the key shown on the confirmation screen.
Copy these values; you'll paste them in the next step:
- API token (the Perdoo personal API key)
2. Paste into PerfCopilot
-
Open Integrations on your PerfCopilot admin.
-
Find the Perdoo card and click Connect (or Manage if already configured).
-
Paste each value into the matching field:
| Field in PerfCopilot | Value from step 1 | |---|---| | API token |
<your value>| -
Click Save.
3. Verify
Click Test in the drawer. Expected:
✅ Authenticated as your.name@company.com
If you see a red error, jump to Common errors.
Common errors
| Message | What it usually means | Fix |
|---|---|---|
| HTTP 401 | Key wrong. | Re-generate the personal API key in Perdoo → Settings → API and re-paste. |
| HTTP 404 on /v1/objectives | API endpoint changed. | Check the Perdoo API changelog for the current path and let us know via hello@perfcopilot.com. |
| HTTP 401: <body excerpt> | Credentials rejected. | Re-check that you copied the full token, no leading/trailing whitespace. |
What signals we pull
goals— current goal list per employee
Need a feature you don't see? Tell us →.