Skip to main content

Culture Amp Setup Guide

Prerequisites

  • A Culture Amp account with an Admin user who has Account Owner permissions. Only these users can create API credentials.

Note: Culture Amp API credentials are account-level. A credential can read all of your account's data within the scopes you grant it, so store it securely and share it only through a secure channel.

Setup Guide

Step 1: Find your environment

  1. Log in to your Culture Amp account.

  2. Check which Culture Amp environment your account uses. You'll select the matching values for Base URL and Target Entity ID in Matia:

    • Production account (api.cultureamp.com) → select Production for both fields.
    • Sandbox account (sandbox.public-api.development.cultureamp.net) → select Sandbox for both fields.

Most customers use Production.

Step 2: Create API credentials

  1. In Culture Amp, click Settings in the top-right navigation menu.

  2. In the left navigation, click API.

  3. Click Create API credentials.

  4. Enter a Credential name, for example Matia.

  5. In the Set credentials scope section, enable the following read scopes:

    • employees-read
    • employee-demographics-read
    • performance-evaluations-read
    • surveys-read
  6. Click Generate API credential.

  7. Copy the Client ID and Client Secret — you'll need both to configure Matia.

Step 3: Complete Configuration in Matia

  1. Select the Base URL you identified in Step 1.
  2. Select the Target Entity ID you identified in Step 1.
  3. Enter the Client ID and Client Secret you copied above.
  4. Enter an Asset Name.
  5. (Optional) Enter a Description.
  6. (Optional) Assign Tags.
  7. Select an Owner.
  8. Verify that your Culture Amp account is successfully connected by clicking on Test Connection.
  9. Click Connect.