Koala

Authentication & Authorization

Credentials

• Koala connects via API Key (see Koala Connection Instructions).
• Publicly exposing your API credentials can allow unauthorized access to the Koala API endpoints, and your Koala data by a third party. DataGrail stores your API credentials encrypted and protected.

Endpoints Utilized

DataGrail uses the following endpoint to validate that credentials are good based on a successful response:

• GET https://app.getkoala.com/api/v1/deletion-requests/0

Version

DataGrail integration currently supports Koala API v1.

Limits

DataGrail processes API responses with HTTP 429 status to interrupt requests, waiting and retrying (using an exponential backoff strategy).

Access

DataGrail supports the Direct Contact Access workflow for Koala.

Deletion

For a deletion request, DataGrail will take the following actions:

• Submit deletion request.. This will schedule a Koala deletion job that will delete all data for requested person.
• Create a scheduling task for regular checking of customer status in Koala using the Checking Deletion Status.
• Deletion request will be in the processing status on DataGrail side until Koala deletes the requested personal data.

Endpoints Utilized

• POST https://app.getkoala.com/api/v1/deletion-requests
• GET https://app.getkoala.com/api/v1/deletion-requests/{deletion_request_id}

note

DataGrail also supports the Direct Contact Deletion workflow for Koala.