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

# Connect your ad accounts

> Link Google Ads and Meta Ads to your workspace, choose the ad account to use, and keep the connection alive.

Every Ad Studio feature works through a connection to an ad account. Each workspace connects at most one Google Ads account and one Meta ad account. Both connections live on the Integrations page, under **Ad Platforms**.

<Note>
  Only workspace **Owners** and **Admins** can connect, change or disconnect ad accounts. Other members see "Not configured. Ask an admin to connect." Ad platform connections need the **Pro** or **Enterprise** plan.
</Note>

## Connect Google Ads

<Steps>
  <Step title="Open Integrations">
    Go to **Settings → Developers → Integrations** and scroll to **Ad Platforms**.
  </Step>

  <Step title="Sign in with Google">
    On the **Google Ads** card, click **Connect Google Ads** and sign in with a Google account that has access to your Google Ads account. When you return, a message confirms "Google Ads connected successfully!".
  </Step>

  <Step title="Choose the account">
    Under **Google Ads account**, pick the account from the list, then click **Save**. If the account isn't listed, choose **Another account (enter its ID)** and type its customer ID. If no list appears, type the customer ID straight away. You'll find it at the top right of the Google Ads interface, in the form `123-456-7890`.
  </Step>
</Steps>

### Accounts under a manager account (MCC)

If you reach the Google Ads account through a manager account, enter the account you advertise from under **Google Ads account**, and the manager's ID under **Manager account (MCC) ID**. Then click **Save**. Google lists only the accounts you can open directly, so a client account under a manager usually has to be typed.

The card then shows "via manager" with the manager's ID. Leave the field blank if you don't use a manager account. To stop using one, empty the field and save.

Audiences you sync and campaigns you publish are created in this account. If you switch to a different customer ID later, audiences created under the old one stay there, and InstantCampaign can no longer find them. See [Verify an audience in Google Ads](/guides/ads/audiences#verify-an-audience-in-google-ads).

### When Google access expires

Google doesn't say in advance when a sign-in expires, so the card shows what is known:

* "Google access expires on …": the connection has a known end date. The text turns amber in the last two days. Click **Reconnect** before then.
* "Google access does not expire; reconnect only if Google revokes it.": nothing to do.
* **Connection expired**: Google no longer accepts the connection. Audience syncs and campaign refreshes stop until you click **Reconnect**.

**Reconnect** runs the Google sign-in again and replaces the stored token. Your selected account, audiences and campaigns are kept. The **Audiences** page shows the same expiry warning and its own **Reconnect** button.

## Connect Meta Ads

<Steps>
  <Step title="Open Integrations">
    Go to **Settings → Developers → Integrations** and scroll to **Ad Platforms**.
  </Step>

  <Step title="Sign in with Facebook">
    On the **Meta Ads** card, click **Connect Meta Ads** and approve the permissions Meta asks for. They include access to your ad accounts, your Facebook Pages and lead-form leads. Campaigns need the Page permissions to publish ads, and lead capture needs them to read leads.
  </Step>

  <Step title="Choose the ad account">
    Under **Ad account**, pick the ad account and click the check-mark button to save it.
  </Step>

  <Step title="Accept Meta's Custom Audience Terms">
    If the ad account hasn't accepted Meta's Custom Audience Terms, the card warns you. Click **Accept Meta's terms**, accept them in Meta Business Manager, then click **Re-check**. When the terms are in place you'll see "Terms accepted — you're all set."
  </Step>
</Steps>

<Warning>
  Until the Custom Audience Terms are accepted, Meta refuses to create or fill audiences for that ad account.
</Warning>

### When the Meta connection needs renewing

A Meta connection lasts about 60 days, and Meta can also revoke it earlier. A workspace connected before Ad Studio added the Page and lead permissions also has to reconnect before it can publish from a Page or capture leads. You'll see this as:

* "Your Meta connection predates Page access. Reconnect Meta Ads to publish from a Page." in the campaign editor
* a publish error saying the access token is no longer valid
* **Reconnect Meta** in the lead capture dialog

To reconnect, click **Reconnect** on the **Meta Ads** card on the Integrations page. The Facebook sign-in runs again, and your ad account, audiences and campaigns are kept. The lead capture dialog's **Reconnect Meta** button does the same.

<Warning>
  Don't use **Disconnect** to renew a connection. Disconnecting removes the connection **and every audience mapping** for that platform. The audiences themselves stay in your ad account, but InstantCampaign stops syncing them. The Disconnect confirmation says so too.
</Warning>

## Disconnect an ad platform

Click **Disconnect** on the platform's card and confirm. This removes the connection and all its audience mappings from InstantCampaign. Audiences that already exist in your Google Ads or Meta ad account are **not** deleted. Pause or archive running campaigns before you disconnect, because InstantCampaign can no longer control them afterwards.

## Troubleshooting

| What you see                                                    | What to do                                                                                                                                                                                                                 |
| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| No accounts in the **Google Ads account** list                  | Type the customer ID shown at the top right of Google Ads, then save.                                                                                                                                                      |
| Google calls fail even though the account appears in Google Ads | Check that the customer ID saved on the card is the account you are looking at in Google Ads, not a manager account. If you reach it through a manager account, enter the manager's ID under **Manager account (MCC) ID**. |
| The Meta **Ad account** list is empty                           | The Facebook user you signed in with has no access to an ad account. Get access in Meta Business Manager, then click **Reconnect**.                                                                                        |
| "Connection expired" on the Google Ads card                     | Click **Reconnect**.                                                                                                                                                                                                       |
| The Meta publish fails with "access token is no longer valid"   | Click **Reconnect** on the Meta Ads card, then publish again.                                                                                                                                                              |
