Sign inGet started
Docs
Get started

Crowdin API Authentication

How to authenticate Crowdin API requests: one Bearer API key plus a connectionId. MindCloud stores your Crowdin API key securely — set it once, never resend it.

Every Crowdin API request through MindCloud needs two things: a MindCloud API Key and a connectionId for your Crowdin account. This page covers both, plus exactly how to send them, so you do not need to visit any other page to get authenticated.

Steps to authenticate

  1. Create a MindCloud account at app.mindcloud.co if you do not already have one.
  2. Generate a MindCloud API Key in API Keys. This is the Bearer token you send on every request. Keep it on your server.
  3. Create a Crowdin connection in Connections. Crowdin uses an API key. You generate the key in your Crowdin account, then paste it in when you create the connection — MindCloud stores it securely and never returns it in a response.
  4. Copy the connection’s connectionId — you will send it on every request alongside your MindCloud API Key.

How requests are authenticated

Authentication has two layers. Your MindCloud API Key authenticates the request to MindCloud, sent as a Bearer token in the Authorization header. The connectionId selects the connected Crowdin account that should run the action. MindCloud stores and refreshes the Crowdin credentials behind that connection, so you never send provider tokens with your requests.

Pass connectionId in the query string for GET and DELETE actions, and in the JSON body for POST, PUT, and PATCH actions.

For example, calling Get Authenticated User with an Crowdin connection looks like this:

curl --request POST \
  --url "https://connect.mindcloud.co/v2/universal/apps/crowdin/actions/get-authenticated-user/run" \
  --header "Authorization: Bearer $MINDCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "connectionId": "$CONNECTION_ID",
  "arguments": {}
}'

The Authorization: Bearer <your MindCloud API Key> header authenticates you to MindCloud; the connectionId tells MindCloud which Crowdin account to run the action against. Missing or invalid Authorization returns 401, and a missing or mismatched connectionId returns 400.

Create a Crowdin Personal Access Token

You need a Crowdin account and access to the projects you want this connection to manage.

  1. Open the API settings

    In Crowdin, click your profile picture in the upper-right corner, select Settings, and open the API tab.

    Settings → API
  2. Start a new token

    Click New Token in the Personal Access Tokens section.

  3. Choose the token settings

    Enter a name, choose an expiration date, and select the required scopes for this MindCloud connection: project.settings, project.source.file, project.status.progress, project.translation, and project.task. If you want to limit the token to specific resources, use Granular access and select the allowed resources.

  4. Create and copy the token

    Click Create, then copy the new token value and paste it into the MindCloud connection form.

Keep your key safe

Keep your MindCloud API Key on your server; do not ship it in browser code, mobile apps, public repositories, or logs. Anyone with the key can call the Universal API as your MindCloud account, across every connection you have created.