Phrase application

Phrase is a translation and localization management platform. MIA connects to Phrase Strings to inventory the users of your account and manage their access.

Authentication type and prerequisites

Authentication type — API key

Prerequisites

You need a Phrase Strings role allowed to manage users, such as Project Manager or Administrator. The Platform token must authorize Phrase Strings and include the team.manage scope.

Connection steps

1. Open the Phrase Platform with your main user, not the token creation page inside Phrase Strings.
2. Go to Profile → Access Tokens, then create an API token authorizing the Phrase Strings service.
3. In the token scopes, manually add team.manage. Keep the read and write scopes offered for Phrase Strings as well.
4. Generate the token, then copy it immediately: Phrase will not display it again.
5. In MIA, open Applications → Add an application, enter this Platform token, then click Connect. MIA automatically exchanges it for a temporary JWT.
6. MIA displays the accounts available to this token: select the account to connect. Its ID is stored automatically.

When adding a user, MIA retrieves the Phrase account's roles list and asks you which role to assign. The Owner role, which cannot be assigned through an invitation, is excluded. Roles limited to specific projects or languages may require an additional assignment directly in Phrase.

WARNING

A token created directly in Phrase Strings with only read and write returns a 403 response for members and invitations. After the exchange, the JWT used by MIA must include strings:read, strings:write, and strings:team.manage.