# 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}`

- `host` (default `test.refapp.se`): test.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

- [Submit a candidate](/reference/account-integration/submitcandidate.md): `POST /webhooks/account-integration`
- [Read the settings available to your account](/reference/account-integration/getconfig.md): `GET /webhooks/account-integration/config`
- [Read the settings available to your account, with the parameters in the body](/reference/account-integration/postconfig.md): `POST /webhooks/account-integration/config`
- [Read a candidate's results](/reference/account-integration/getcandidateresults.md): `GET /api/v1/account/projects/{projectId}/candidates/{candidateId}/results`

## Webhooks

- [Results pushed to your endpoint](/reference/account-integration/receivecandidateresults.md): `PUT` to your endpoint
