> ## Documentation Index
> Fetch the complete documentation index at: https://docs.immitranslate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect eimmigration

> Connect your firm's ImmiTranslate account to eimmigration. It takes a few minutes and is done once.

Connecting is a two-way exchange. ImmiTranslate gives you an **API key** to paste into eimmigration, and eimmigration gives you a **webhook URL** to paste into ImmiTranslate. Keep both open in separate browser tabs.

## 1. Open the connect page

Go to [immitranslate.com/apps/eimmigration](https://immitranslate.com/apps/eimmigration) and say whether your firm already has an ImmiTranslate account.

![The connect page: Connect eimmigration to ImmiTranslate, asking Do you already have an ImmiTranslate account? with Yes, log in and No, create an account buttons](https://mintcdn.com/immitranslate/62eYfPKwyYKo5OXq/images/integrations/eimmigration/connect-page.webp?fit=max\&auto=format\&n=62eYfPKwyYKo5OXq\&q=85\&s=9ebcf162ac3157a8ffaab14e296ed09c)

The connect page

* **Yes, log in** signs you in to your existing account.
* **No, create an account** opens a new account for your firm. You can use Google or Microsoft.

Once you're in, eimmigration is connected to that account and the page shows your API key. If you were already signed in to ImmiTranslate, the page asks you to confirm the account first; choose **Connect**.

![The connect page after connecting: step 1, Copy your API key, with the key and a Copy button; step 2, Paste your webhook URL, with a Webhook URL field and a Save webhook URL button](https://mintcdn.com/immitranslate/62eYfPKwyYKo5OXq/images/integrations/eimmigration/connect-connected.webp?fit=max\&auto=format\&n=62eYfPKwyYKo5OXq\&q=85\&s=034a115aca24dfe2a9a8c14163735fb1)

After connecting: your API key, and a field for eimmigration's webhook URL

> [!NOTE]
>
> Some accounts only let their admins connect apps. If the page says so, ask one of the admins it names to connect eimmigration.

## 2. Paste the API key into eimmigration

In eimmigration, open **Administrator**, then **Application Settings** under Tools.

![The Administrator home page in eimmigration, with Application Settings under Tools](https://mintcdn.com/immitranslate/62eYfPKwyYKo5OXq/images/integrations/eimmigration/administrator-home.webp?fit=max\&auto=format\&n=62eYfPKwyYKo5OXq\&q=85\&s=e6034e12aa56657957d684fbd7a04772)

Administrator → Application Settings

Choose **ImmiTranslate** in the menu on the right, then:

1. Turn on **Enable ImmiTranslate Integration**.
2. Paste the key from the connect page into **API Key**.
3. Choose **Test Connection** to check the key works.
4. Choose **Save**.

![The ImmiTranslate Settings page in eimmigration: the Enable ImmiTranslate Integration switch, an API Key field, a Test Connection button, the Webhook URL with a copy button, and Regenerate](https://mintcdn.com/immitranslate/62eYfPKwyYKo5OXq/images/integrations/eimmigration/immitranslate-settings.webp?fit=max\&auto=format\&n=62eYfPKwyYKo5OXq\&q=85\&s=45cc0748d85ea984747c08935c8926ab)

Administrator → Application Settings → ImmiTranslate

## 3. Paste the webhook URL into ImmiTranslate

On the same eimmigration page, copy the **Webhook URL** with the button at the end of the field. Back on the ImmiTranslate connect page, paste it into **Webhook URL** and choose **Save webhook URL**.

This is how eimmigration hears that a quote is ready, an order has started or a translation is complete. Without it, requests stay at their first status in eimmigration and finished translations don't arrive in the case.

> [!WARNING]
>
> Treat the API key and the webhook URL like passwords. Anyone with the key can act as your ImmiTranslate account, and the webhook URL contains a secret.

That's it. Your team can now [request translations](https://docs.immitranslate.com/integrations/eimmigration/request-a-translation.md) from any case.

## Managing the connection

The connection lives in your ImmiTranslate account under [Settings → Integrations → eimmigration](https://portal.immitranslate.com/settings/eimmigration). There you can see the API key again, change the webhook URL, or disconnect.

| If you... | Then... |
| - | - |
| Choose **Regenerate** next to the webhook URL in eimmigration | The old URL stops working. Copy the new one and save it in Settings → Integrations → eimmigration. |
| Revoke the integration's key in Settings → API Keys | eimmigration can no longer reach your account. Create a new key in Settings → Integrations → eimmigration and paste it into eimmigration. |
| Choose **Disconnect** | The API key stops working immediately and ImmiTranslate stops sending events to eimmigration. Orders already placed are not affected, and you can connect again at any time from the connect page. |

## Troubleshooting

**Test Connection fails.** Copy the key again with the **Copy** button so nothing is cut off, and check in Settings → Integrations → eimmigration that the key hasn't been revoked.

**Requests don't update in eimmigration.** Compare the webhook URL in eimmigration with the one saved in Settings → Integrations → eimmigration. They must match exactly, and the URL changes whenever someone chooses **Regenerate**.

Still stuck? Email [developers@immitranslate.com](mailto:developers@immitranslate.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.