Refapp Account Integration API
Connect your own system to Refapp: submit candidates for reference checking and read their results back. One bearer token identifies and authenticates your account.
Base URL
https://{host}
hostdefault test.refapp.setest.refapp.se while developing. In production, the host your account lives on, usually app.refapp.se.
Authentication
Authorization: Bearer <token>
The token Refapp issued for your account. It identifies the account, so nothing else is needed.
Endpoints
- POSTSubmit a candidate
/webhooks/account-integration - GETRead the settings available to your account
/webhooks/account-integration/config - POSTRead the settings available to your account, with the parameters in the body
/webhooks/account-integration/config - GETRead a candidate's results
/api/v1/account/projects/{projectId}/candidates/{candidateId}/results
Webhooks
Requests Refapp sends to your system.
- PUTResults pushed to your endpoint
candidateResultsPush