> For the complete documentation index, see [llms.txt](https://help.parta.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.parta.io/translation/translate-a-course-with-ai/phrase-integration.md).

# Phrase Integration

Connect Phrase with Parta.io to translate courses and return completed translations.

## What is Phrase?

Phrase is the world’s leading Language Intelligence Platform that automates, manages, and delivers multilingual content for deeper customer connections and faster business growth.

{% hint style="success" %}
**How the integration works?**

1. The integration sends Parta.io courses to Phrase for translation.
2. After translation, Phrase returns the course to Parta.io.
3. Then you can edit or publish it.
   {% endhint %}

## Set the Phrase Integration

### 1. Get Required URL from Parta.io

Open your [Parta.io account](https://app.parta.io/?).

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2F42dq8ZkYFqOI4wgUNCqN%2FPhrase_integration.01.png?alt=media&amp;token=18f8e694-785c-4a2e-985b-01ec63c949d6" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
Go to **Company Settings** tab.
{% endstep %}

{% step %}
Go to **Translation** tab.
{% endstep %}

{% step %}
Hover over **Phrase** and click **Connect**.

A pop-up window will appear.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2F4WZRMWzpaFxl3AgW56zk%2FPhrase_integration.02.png?alt=media&amp;token=a2ae6a58-490f-4667-9ad6-40fe56d89d01" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Copy the **Redirect URL** from the **Integration setup** section.
{% endstep %}
{% endstepper %}

### 2. Create an OAuth app in Phrase

In new browser tab open your [Phrase](https://phrase.com/) account.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2F8gbLZaeYPFXd8OpZLRAi%2FPhrase_integration.03.png?alt=media&amp;token=38e97adf-3072-471f-ae22-9389915f60c2" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
Select **Phrase TMS**.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FRSr3PDRx8SDuXnPu9bFH%2FPhrase_integration.04.png?alt=media&amp;token=b6326de0-daed-4310-bc5a-101718fbc63c" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Go to the **Settings** tab.
{% endstep %}

{% step %}
Scroll to the **Integrations** section and select **Registered OAuth Apps**.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FketcNYpoWiJtyYW9P9mW%2FPhrase_integration.05.png?alt=media&amp;token=a583521a-f00b-47fe-ae21-a8acea8f47f1" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **+New.**

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FJbP0opTe88MFm2BHDpMA%2FPhrase_integration.06.png?alt=media&amp;token=bbb4cc78-12e4-4566-ad08-9bb4839ec726" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Enter any descriptive name (e.g., '[Parta.io](http://parta.io/)') at the **Name** field.
{% endstep %}

{% step %}
Paste a Redirect URL copied at the [step 1](#user-content-fn-1)[^1] to the **Redirect URL** field.
{% endstep %}

{% step %}
Enter any additional info at the **Description** field (optional).
{% endstep %}

{% step %}
Click the **Save** button.

A new record will appear at the list of apps.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FRYqSypeFthBECCF9PvYm%2FPhrase_integration.07.png?alt=media&amp;token=c74d963f-78ca-4e49-a270-4333a30aa0a6" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Copy the ID at the **Client ID** column.
{% endstep %}
{% endstepper %}

### 3. Connect Phrase with Parta.io

Open your [Parta.io account](https://app.parta.io/?).

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2F42dq8ZkYFqOI4wgUNCqN%2FPhrase_integration.01.png?alt=media&amp;token=18f8e694-785c-4a2e-985b-01ec63c949d6" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
Go to **Company Settings** tab.
{% endstep %}

{% step %}
Go to **Translation** tab.
{% endstep %}

{% step %}
Hover over **Phrase** and click **Connect**.

A pop-up window will appear.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FTtKbKlfwbyj9FHt9pKBY%2FPhrase_integration.08.png?alt=media&amp;token=dc9a7030-2be8-4e1c-a7b1-6305b9ec2ab5" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Select the Phrase **Data Center** that matches your account.
{% endstep %}

{% step %}
Paste the **Client ID** from Phrase.
{% endstep %}

{% step %}
Copy the **Redirect URL** at the **Webhook setup** section.
{% endstep %}
{% endstepper %}

{% hint style="danger" %}
Do not close this connection window yet. Parta.io saves the Client ID only after setup completes.
{% endhint %}

### 4. Create a webhook in Phrase

In new browser tab open your [Phrase](https://phrase.com/) account.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2F8gbLZaeYPFXd8OpZLRAi%2FPhrase_integration.03.png?alt=media&amp;token=38e97adf-3072-471f-ae22-9389915f60c2" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
Select **Phrase TMS**.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FvELrAyhrnaDAqXIG9Pps%2FPhrase_integration.09.png?alt=media&amp;token=4fa84655-7aa0-409a-be84-da7992107ce1" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Go to the **Settings** tab.
{% endstep %}

{% step %}
Scroll to the **Integrations** section and select **Webhooks**.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FCh4BM7iyJWTJyCaT3a5x%2FPhrase_integration.10.png?alt=media&amp;token=f51a371c-c707-4807-9d6d-52119047edf1" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **+Add webhook** or **+ New**.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FycLZrXpx865Ne2mnjxmY%2FPhrase_integration.11.png?alt=media&amp;token=6906d03a-1540-43d4-a85b-4e3ace077c09" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Paste the Parta.io redirect URL into the **URL** field.
{% endstep %}

{% step %}
Enable the **Job status changed** toggle.
{% endstep %}

{% step %}
Click the **Create Webhook** button.
{% endstep %}
{% endstepper %}

### 5. Authorize the integration

Return to your [Parta.io connection window](#id-3.-connect-phrase-with-parta.io).

{% stepper %}
{% step %}
Click the **Save** button.

A new **Phraze** log in window will appear.
{% endstep %}

{% step %}
Complete [authorization in Phrase](https://support.phrase.com/hc/en-us/).
{% endstep %}

{% step %}
Select **Allow**.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FSIYume7IqLAV3UJJqfb7%2FScreenshot%202025-04-30%20at%2014.38.42.png?alt=media&amp;token=adc14fa7-dbac-49d4-9ddb-88cb28a32972" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### 6. Configure the Phrase workflow

Phrase uses a workflow step to return completed translations to Parta.io.

Open your [Phrase](https://phrase.com/) account.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2F8gbLZaeYPFXd8OpZLRAi%2FPhrase_integration.03.png?alt=media&amp;token=38e97adf-3072-471f-ae22-9389915f60c2" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
Select **Phrase TMS**.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FNBOoX3vs4lpCU8lxAZZy%2FPhrase_integration.12.png?alt=media&amp;token=82ae4248-7d4c-4ce3-a53c-f1c4726ad655" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Go to the **Settings** tab.
{% endstep %}

{% step %}
Scroll to the **Project settings** section and select **Workflow steps**.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FzzukmoVDVipmQgMl8c1i%2FPhrase_integration.13.png?alt=media&amp;token=a14c83db-aabd-4551-8a2d-57daec63d07a" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **+New workflow step**.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FjNbgCyaT2TUaobgtCJ8B%2FPhrase_integration.14.png?alt=media&amp;token=d703d20b-8391-4fb5-95f9-4c541aba519d" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Enter `Push to Parta` as the workflow step name.
{% endstep %}

{% step %}
Enter the abbreviation value.

The value is based on your internal process.
{% endstep %}

{% step %}
Enter the order value.

The value is based on your internal process.
{% endstep %}

{% step %}
Click the **Create** button.
{% endstep %}

{% step %}
Add **Push to Parta** to each localization template used with Parta.io.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
The workflow step name must be exactly `Push to Parta`. Mark this step as **Completed** to return the translation.
{% endhint %}

## Translate a Project with Phrase

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FkxGyUB6JpiJpeZQyFkEs%2FLara_integration.03.png?alt=media&amp;token=adcf32e9-792f-4e5c-9471-e6367b58954e" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
[Open a Project](https://help.parta.io/project-general-settings/set-a-project/manage-a-project) and go to the **Translation** tab
{% endstep %}

{% step %}
Click **AI Translation**.
{% endstep %}

{% step %}
Select **Phrase** at the **Provider** drop-down menu.
{% endstep %}

{% step %}
Select a translation template.

The project name and languages are pre-filled.
{% endstep %}

{% step %}
Click the **Translate** button.
{% endstep %}
{% endstepper %}

When the **Push to Parta** step is completed, the translated course appears in **Catalog**.

{% hint style="warning" %}
Phrase uses the Parta.io project name by default. Duplicate names receive an index.
{% endhint %}

[^1]: **In Parta.io:** Go to **Company Settings → Localization → Connect →** Copy **Redirect URL.**
