# Connecting accounts

Connect your ad platforms, analytics, and messaging channels to Soku — including Google, Meta, TikTok, GA4, Slack, and Lark via a custom app.

# Connecting accounts

The agent works best when it can see your data. You connect accounts from **Settings → Integrations** inside a brand. The page has three tabs, split by **who owns the account** and **whether you need to connect it**:

| Tab | What it is | Do you connect it? |
|---|---|---|
| **Bring Your Own** | Your own ad, analytics, and productivity accounts (Meta, Google, GA4, Notion…) | Yes — you authorize each one |
| **Built-in** | Third-party tools Soku provides (creative generation, SEO data, voice…) | No — available automatically |
| **Channels** | Messaging channels for routing conversations (Slack, Lark) | Yes — you connect each one |

> Connecting and managing accounts usually requires organization **Admin** permissions. Members can only view connection status. See [Inviting your team](/docs/inviting-your-team) for roles.

## Bring Your Own — connect your own accounts

These are your accounts. You authorize each one, and Soku reads (and where supported, writes) your data.

| Integration | What it's for |
|---|---|
| Meta Ads | Connect your Meta ad account for insights and optimization |
| Google Ads | Connect your Google ad account for insights and optimization |
| TikTok Ads | Connect your TikTok ad account for insights and optimization |
| GA4 | Track conversions and user behavior |
| PostHog | Analyze funnels, retention, and product events |
| ChatGPT Ads | Install the Soku Pixel and view ChatGPT Ads report accounts |
| Stripe | Look up payments, customers, and subscriptions |
| Notion | Create pages and query databases |
| Gmail | Read and send messages from your account |
| Google Docs / Sheets / Drive | Create, read, and manage files in your Drive |

## Built-in — provided by Soku, no setup

Third-party services pre-integrated by Soku — your skills and agents use them out of the box, **no credentials required**. These power capabilities like creative generation, competitor research, SEO data, and voice.

- **Web data:** Apify, Enrich.so, Exa search, People Data Labs, Firecrawl, ScreenshotOne
- **Image / video generation:** Nano Banana 2 (Google Gemini), GPT Image 2, Creatify, Seedance 2.0
- **Voice:** ElevenLabs, Deepgram
- **Ads / app / creator intelligence:** Foreplay, AppTweak, Nox Influencer
- **SEO:** DataForSEO, Ahrefs
- **Performance:** Google PageSpeed

You don't connect these — they're available automatically.

## Channels — connect messaging apps

Messaging channels you connect to route conversations into Soku: **Slack** and **Lark**.

---

## How to connect

### Connect an ad or analytics platform (Meta, Google, TikTok, GA4)

1. On the platform's card, click **Connect**.
2. You're taken to the provider's site to complete OAuth — sign in and authorize Soku to read your data.
3. After authorizing, Soku imports your ad accounts automatically. If you have multiple brands, choose which brand to assign each account to.
4. A connected card shows how many accounts are linked. If it shows **Needs re-auth**, click the card to re-authorize.

### Connect a channel (Slack, Lark)

Switch to the **Channels** tab to connect **Slack** and **Lark** and bring chat messages into Soku.

#### Connect Lark via a custom app

Lark connects through a custom app you create on the Lark Developer Platform. Click **Connect** on the Lark card, then in the dialog:

1. Copy the **Webhook URL** and paste it into the Lark Developer Platform → **Events & Callbacks** → URL configuration.
2. From your Lark app's backend, copy the **App ID**, **App Secret**, and **Verification Token**, and paste them into the dialog.
3. Click **Save Lark install**. Once the first event passes verification, the status changes from `pending` to `connected`. Then add the bot to a group chat and bind it to the corresponding brand.

> **Heads up:** the Lark app must have **Encrypt mode turned off**, or event verification will fail.

## Troubleshooting

- **Can't find the Connect button, or can't connect an account?** Connecting requires organization Admin permissions — ask your organization admin.
- **Card shows "Needs re-auth"?** The provider's authorization expired. Click the card and re-authorize.
- **Dashboard shows no data after connecting?** Make sure the account is assigned to the brand you're currently viewing.