Connect Integration to Phrase
This setup connects Phrase with Parta.io using OAuth 2.0 and involves two steps on both the Phrase and Parta.io sides. To establish connection follow the steps below.
How the Integration Works
The integration between Parta.io and Phrase lets you send courses for translation and receive them back ready for polishing or publishing. Here’s the high-level flow:
Create a course in Parta.io that needs localization.
Push content to Phrase with one click.
Confirm the 'Push to Parta' workflow step exists in Phrase.
On the Phrase side, translate the content and mark the workflow step as complete.
In Parta.io, retrieve the translated course for final edits or LMS publishing.
Step 1: Set Up OAuth in Phrase
In your Phrase organization, navigate to TMS → Settings → scroll down to the Integrations → Registered OAuth Apps.
Retrieve the Client ID
After saving, find the new OAuth connection in the Registered OAuth Apps list.
Copy the Client ID.
Phrase -> Settings -> Registered OAuth apps
Step 2: Connect OAuth in Parta.io
Go to Parta.io → Company Settings → Localization → Connect.
In the modal:
Select your Data Center (US or EU—based on your Phrase account).
Paste the Client ID.
Additional Information
The Client ID is not stored until all integration steps are successfully completed. Do not exit the setup process prematurely.
If you encounter the error 'No auth found by client_id' in Phrase, ensure that:
You are using a valid Client ID.
You repeat the integration steps correctly.
Step 3: Create Webhook
Copy the Redirect URL in the modal window.

In Phrase, go to TMS → Settings → Webhooks.
Click Add webhook and:
Paste the URL into the URL field.
Enable the event: Job status changed.
Click Create Webhook to save.
Important
Enable the event in Phrase before saving your webhook: Job status changed.
Click Save to connect the integration.
Step 4: Authorize the Integration:
Follow the authorization process in Phrase.
Click Allow to confirm and complete the connection.

Configure the Workflow Step in Phrase
To send translated courses back to Parta.io, a specific workflow step must be set up:
In Phrase, go to TMS → Settings → Project settings → Workflow steps.
Click New workflow step and fill in:
Name:
Push to Parta
(must match exactly)Abbreviation and Order: Based on your internal process.
Click 'New workflow step' and fill in:
Name:
Push to Parta
(must match exactly)Abbreviation and Order: Based on your internal process.
Add the
Push to Parta
step to any localization templates used for Parta.io.
Important:
The workflow step must be named exactly
Push to Parta
—otherwise, Parta.io won’t recognize it.The step’s status must be
Completed
(you can automate or set it manually).
Permissions
To set up the integration, you’ll need Administrator access.
To send a course for translation, you’ll need the Create Course permission.
When everything is set up, you're ready to translate your project. 📘 Learn how to translate a project using Phrase
Last updated
Was this helpful?