Source: https://www.brixit.io/docs/integrations-overview

# How integrations work

Brixit manages the shared applications for Meta Ads, Google Ads, TikTok Ads,
Gmail, Outlook and Google Calendar. Connect your own business account, approve access with the
provider, and choose how Brixit handles your leads, email or calendar. Your team does not need
to create developer applications or enter shared application credentials. Provider approval and account permissions still apply.

Your advertising accounts, campaigns and mailboxes remain yours. Brixit handles the connection;
your team chooses which accounts to authorise and how to use them in the CRM.

## Before you connect

- Use a provider account with access to the pages, advertising accounts or mailbox you need.
- Make sure your Brixit role allows you to manage the integration. If the page or action is
  missing, ask your administrator to check your permissions.

## Connect an account

1. Open **Integrations → Apps** and choose **Meta Ads**, **Google Ads** or **TikTok Ads**.
2. Select **Connect**, sign in with the provider and review the requested access.
3. Complete authorisation and return to Brixit. Allow pop-ups if the sign-in window does not open.
4. Open the connected account and review the available pages, accounts and forms.
5. Configure each lead form's field mappings and assignment strategy, then save.
6. Check a new submission in Brixit before relying on the connection for a live campaign.

Connecting an account and configuring its forms are separate steps. For Google Ads, saving a
form also configures delivery automatically; check **Automatic delivery enabled** in its
**Lead delivery** column. See the [Google Ads guide](https://www.brixit.io/docs/google) for delivery statuses and
provider approval requirements.

### Add new lead forms

Create the form in your advertising platform, then refresh the connected account, page or
advertiser in Brixit. Configure the new form's mappings and assignment strategy and save.
Repeat for each form. Refreshing discovers forms; it is not a historical lead import.

### How leads are routed

The connected provider account and its pages or forms identify the destination CRM
installation. Within that CRM, the integration account identifies your company and the saved
form settings control field mapping and team assignment. Customers using different CRM
domains do not need to copy webhook URLs into their advertising accounts.

For Google Ads, the form ID identifies the registered connection and Brixit configures a
verification key for that form automatically. Contact support before moving an ad account or
form between CRM installations so its existing routing can be reviewed.

## Connect email and calendar

For email, connect your mailbox from **User profile → Profile settings → Email Box**. See the
[email guide](https://www.brixit.io/docs/email) for mailbox connections and company email delivery. Open the
**User profile** menu by clicking your avatar or name in the top-right corner. Personal
settings open in a dialog; **AI connections** is another tab in that dialog and also has a
shortcut in the user profile menu. Company configuration remains under **Settings**.

For Calendar, select **Connect Google Calendar** from **Calendar**, or open
**Integrations → Apps → Google Calendar**. Follow the [Google Calendar guide](https://www.brixit.io/docs/google-calendar)
for sync behaviour and verification. Gmail, Calendar and Ads each require their own connection,
even if you use the same Google account.

## Connect WhatsApp

For WhatsApp, open **Integrations → Apps → WhatsApp** and connect your business number
through Meta. Follow the [WhatsApp setup guide](https://www.brixit.io/docs/whatsapp) for conversations,
templates, campaigns and workspace requirements.

## Who manages each service

| Service | What your team does | Managed by |
| --- | --- | --- |
| Meta, Google and TikTok ads | Authorise your account, configure forms and check lead delivery | Brixit manages the shared provider connection |
| WhatsApp | Connect your business number, configure team access and review consent | Your company; Meta bills your business directly |
| Gmail and Outlook inboxes | Connect your mailbox and choose whether to share conversations | Brixit manages the provider application |
| Google Calendar | Connect your Google account and check its primary calendar | Brixit manages the provider application |
| Google Maps and mobile push | Use the enabled features; allow device notifications for push | Brixit |
| Company email delivery | Configure your company's SMTP service | Your company |
| Cloudflare Turnstile | Configure your company's bot protection | Your company |
| Property portals | Connect your brokerage account and configure listings and leads | Your company |
| Realtime messaging infrastructure | Use messaging in Brixit | Your installation |
| AI assistants through MCP | Connect your AI app to your own CRM domain and approve access | Your installation; direct connection to the AI provider |
| n8n workflows | Create a Brixit automation connection and configure your workflow | Your team; direct connection to your CRM |

Brixit handles the shared service setup automatically. Your team still needs to authorise
its own advertising accounts and mailboxes, then configure them on the integration's page.
Manage your company's own settings, such as SMTP and bot protection, under
**Settings → Services & Credentials**.

For company-managed setup, follow the [portal guide](https://www.brixit.io/docs/portal-integrations),
[Bayut and dubizzle guide](https://www.brixit.io/docs/bayut), [email guide](https://www.brixit.io/docs/email) or
[Turnstile guide](https://www.brixit.io/docs/turnstile).

## If a connection needs attention

For n8n, follow the [n8n setup guide](https://www.brixit.io/docs/n8n) to connect an HTTP Request node to
your CRM using a Brixit automation key.

For ChatGPT, Claude and Gemini, use the separate [AI connections (MCP) guides](https://www.brixit.io/docs/mcp).
These connect directly to your installation and do not use a shared Brixit MCP service.
Explore the integration pages for [ChatGPT](https://www.brixit.io/integrations/chatgpt),
[Gemini](https://www.brixit.io/integrations/gemini) and [Claude](https://www.brixit.io/integrations/claude) for use cases and availability.

If authorisation fails, check that you signed in to the intended provider account and approved
the required access. Reconnect when Brixit asks you to authorise again.

If the service is unavailable, contact Brixit support. Share the provider name, affected account or form,
time of the problem and the message shown in Brixit so support can investigate.
