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.
Last updated
Was this helpful?
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.
Last updated
Was this helpful?
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 “ 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.
In your Phrase organization, navigate to TMS → Settings → scroll down to the Integrations → Registered OAuth Apps.
Click New and enter the following details:
Name: Any name (e.g., "").
Redirect URL (Callback): required
Copy this URL from your account:
Go to Company Settings → Localization → Connect.
In the modal window, copy the Redirect URL.
Description: required field.
Click Save.
Retrieve the Client ID
After saving, find the new OAuth connection in the Registered OAuth Apps list.
Copy the Client ID.
Go to Parta.io → Company Settings → Localization → Connect.
In the modal:
Select your Data Centre (US or EU—based on your Phrase account).
Paste the Client ID.
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.
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.
Follow the authorization process in Phrase.
Click Allow to confirm and complete the connection.
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).
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. 📘