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

> ## Agent Instructions
> For API operations, fetch https://gateway.firsttouch.ai/api/public/openapi.json for the complete input/output schemas, internal references, and x-mcp-annotations. Endpoint Markdown intentionally omits generated schema fragments. Select /api/public/tools/<tool_name> using the exact underscore-separated name. Send requests to https://gateway.firsttouch.ai; the canonical document currently omits servers. Start at https://docs.firsttouch.com/api-reference/agent-start.md.

# Social Integration

> Connect LinkedIn with the FirstTouch Chrome extension or your sign-in details, complete verification, and check the first sync.

## Connecting Your Account

Connect your LinkedIn account in **Settings > User Accounts** to use LinkedIn actions in FirstTouch.

> [!NOTE]
>
> FirstTouch supports one social account per user. Your active team must have LinkedIn access, and you need a sender-enabled seat. View-only users cannot connect an account. If **Add account** is locked, check its message for the required access or billing change.

Before you connect, check that you are in the intended FirstTouch team and review the [safety checklist](https://docs.firsttouch.com/Safety-Checklist.md). By connecting, you confirm that you are not using other tools to automate LinkedIn outreach.

At least 100 LinkedIn connections is recommended for account readiness; the connection form does not require confirmation of that minimum.

### Connect with Chrome extension — recommended

The FirstTouch Chrome extension uses your signed-in LinkedIn browser session. You do not need to enter your LinkedIn password in FirstTouch or install a separate connection extension.

**1. Open the connection drawer**

In FirstTouch, open **Settings > User Accounts**. Under **Social account**, click **Add account**.

**2. Open or install the extension**

**Use Chrome extension** is selected by default and marked **Recommended**. Click **Continue** to open the extension.

If Chrome Web Store opens, install the FirstTouch extension and return to FirstTouch. If you see **FirstTouch extension is ready**, click **Continue** to finish connecting in the extension. You do not need to install it again.

**3. Check your LinkedIn profile**

Sign in to FirstTouch and the intended LinkedIn account in the same Chrome browser. If the extension asks you to log in to LinkedIn, use **Open LinkedIn** if shown and sign in.

Check the profile shown in the extension before connecting. If it is the wrong profile, switch accounts on LinkedIn first.

**4. Choose your settings and connect**

Choose your **Conversations sync policy** and **Country**. Use the country where you usually sign in to LinkedIn. Review the safety statement, then click **Connect**.

### Connect with email and password

**1. Choose Sign in with LinkedIn**

In the **Connect account** drawer, select **Sign in with LinkedIn** and click **Continue**.

**2. Enter your sign-in details**

Enter your **LinkedIn email** and **LinkedIn password**.

To let FirstTouch reconnect after a disconnect, turn on **Keep me always connected** and enter your **LinkedIn 2FA key**. This is optional. Follow [Find your LinkedIn 2FA key](https://docs.firsttouch.com/WebApp/Settings/linkedin-2fa-key.md) to copy the authenticator secret key, not a temporary verification code.

SMS verification does not replace the authenticator-app key for this optional setting. Never send passwords, codes, or keys to support.

**3. Choose your settings and connect**

Select **Country**, using the country where you usually sign in. Choose your **Conversations sync policy**, review the safety statement, and click **Connect**.

**4. Complete verification if requested**

If LinkedIn asks for a code, enter it in the FirstTouch verification dialog and click **Connect**.

If **Check your LinkedIn app** appears, open LinkedIn on your phone and approve the sign-in by tapping **Yes, it's me**. If you cannot use that approval method, click **Try another way** to request another LinkedIn verification method.

### Choose which conversations to sync

Both connection methods offer **Conversations sync policy**:

* **Only track conversations started in FirstTouch** is the default. Use it to track only conversations started in FirstTouch.
* **Track and import all LinkedIn conversations** imports conversations from the past 30 days and keeps all future conversations synced, including those started outside FirstTouch. In the web app, review the privacy notice and click **Track all conversations** to confirm this option.

> [!WARNING]
>
> If you track all conversations, personal or sensitive messages may be visible to your team owner and admins in Unibox. The import can take a few minutes. This is separate from the initial connections sync described below.

## Connection progress

While connecting, FirstTouch shows **Connecting your LinkedIn** with these steps:

1. **Connecting to LinkedIn**
2. **Securing the connection**
3. **Confirming your account**

Connection can take a few minutes. The progress bar is a visual guide, not an exact completion estimate. **Connected** confirms the connection step; your first connections sync may still be pending.

If **Taking longer than usual** appears, you can close the panel. FirstTouch keeps connecting and shows progress in the app. Check **Settings > User Accounts** for verification requests or changes in status.

## Wait for the initial sync

After connection, FirstTouch imports your LinkedIn connections so flows can use current connection information. The first sync can take a few hours. This is not the same as signing in or importing conversation history.

You may see these banners on the **Dashboard** or in **Settings > User Accounts**:

| Banner | What to do |
| :- | :- |
| **Syncing in progress** | Wait while FirstTouch imports your connections. You can prepare signals and flows during this time. |
| **Sync complete** | The connections sync has finished. Click **Done** to dismiss the message. |

Social actions waiting for this sync continue automatically when it finishes, subject to your sending schedule, limits, and any other requirements. You do not need to reconnect just because the account is syncing.

> [!NOTE]
>
> **Available** means the account is connected. It does not by itself confirm that the first sync has finished. The initial-sync banner is not shown for every account or browser session, so its absence is not proof of completion. Open the account's menu, choose **Account settings**, and check **Sync status > Last sync time** for the last completed connections sync.

See [Outreach Queue](https://docs.firsttouch.com/WebApp/Outreach-Queue.md#common-delay-reasons) for other reasons a social action may be waiting.

## Troubleshooting Statuses

Check your connection status in **Settings > User Accounts**. Use the action shown for your account.

| Status | What it means | Action required |
| :- | :- | :- |
| **Available** | The account is connected. Initial sync may still be pending. | Check the sync information before expecting social actions to run. |
| **Connecting** | FirstTouch is establishing the connection. | Wait and complete any verification request. |
| **2FA code required** | Your account requires a two-factor authentication code. | Open **Enter PIN** and submit the code. |
| **OTP code required** | LinkedIn requested a one-time code. | Open **Enter PIN** and enter the code from the source shown in the dialog. |
| **Confirm in LinkedIn app** | LinkedIn is waiting for mobile-app approval. A countdown may be shown. | Approve the sign-in on your phone, or use **Try another way** if you cannot approve it. |
| **Action required** | The platform requested extra verification or another manual check. | Review the account and use **Re-log** if needed. |
| **Disconnected** | The account session expired or was disconnected by the system. | Click **Re-log** to reconnect. |
| **Pending removal** | The disconnected account has a reconnect deadline. | Check the deadline shown for the account and use **Re-log** before it expires. |
| **Restricted** | LinkedIn needs you to complete a check on the account before activity can continue. | Log in to LinkedIn directly, complete any steps it shows, then click **Re-log** to reconnect. |

## Recovery Actions

### Try another way

The action depends on where you see the button:

| Where it appears | What it does |
| :- | :- |
| Password-connection error in the web app | Opens the FirstTouch Chrome extension to connect with your browser session. |
| Connection error in the extension | Opens email-and-password sign-in in the FirstTouch web app. |
| **Check your LinkedIn app** dialog or an account waiting for mobile approval | Requests another LinkedIn verification method. Follow the next prompt if one is available. |

Switching methods does not bypass LinkedIn verification. You can also use **Connect with the FirstTouch Chrome extension** from the password form.

### Other recovery actions

* **Try again:** Retries the connection. If your sign-in details are rejected, correct them before connecting again.
* **Re-log:** Reconnects an account that needs attention or was disconnected.
* **Enter PIN:** Used when the platform asks for a verification code.
* **Resend** or **Resend code:** Requests another SMS, email code, or mobile approval when supported. Wait for any countdown. Authenticator-app codes cannot be resent, and resend attempts are limited.

If FirstTouch says the LinkedIn account is already connected, follow the specific account or team message shown. Do not repeatedly retry or remove an account without checking which connection is affected. If a daily connection limit is reported, follow the reset guidance shown; **Cancel** may replace **Try again**.

An account can be active for sending in only one Team. A conflict can identify the other Team by name.

Reconnecting a matching account can preserve settings, LinkedIn Profile Connections, and stored messages. Older conversations may need synchronization before reads and replies resume.

After disconnection, Free or trial Teams can receive an approximately 72-hour reconnect window. Paid non-trial Teams retain the disconnected account without an automatic cleanup deadline. Disconnected accounts cannot run new LinkedIn actions. Permanent removal or entitlement cleanup can bypass retention.

Reconnect notifications wait 12 hours and are suppressed if the account reconnects within that interval. A missing immediate notification does not confirm that the account stayed connected.

## After You Connect

In **User Accounts**, open the account's menu and choose **Account settings** to view **Social account details**:

* **Daily limits** for profile views, connection requests, and messages
* **Location** used for the account connection
* **Conversations sync policy** for LinkedIn messages in FirstTouch
* **Sync status > Last sync time** for your LinkedIn connections

Click **Save** after changing daily limits or the conversations sync policy.

You should also configure when automation is allowed to run in [Sending Schedule](https://docs.firsttouch.com/WebApp/Settings/sending-schedule.md).

> [!NOTE]
>
> If your social account disconnects, Social Platform steps in active flows will stop running until the account is reconnected.


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