> For the complete documentation index, see [llms.txt](https://help.meetmadison.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.meetmadison.ai/getting-started/connect-your-integrations.md). # Connect your integrations Madison works by connecting to services you already use - Google, Meta, your CRMs, and more. Each connection is called an **integration**. Within each integration you have one or more **accounts** (a specific Facebook Page, a Google location, and so on), which you assign to your Madison locations so your data lands in the right place. You can connect integrations during setup, or any time from **Settings → Integrations**. For the full list of what you can connect, see [Integrations](/settings/integrations.md). ## How to connect an integration {% stepper %} {% step %} #### Go to Settings → Integrations Open **Settings** from the left-hand menu, then choose the **Integrations** tab. {% endstep %} {% step %} #### Choose what to connect and sign in Find the service and select **Connect**. A window opens for you to sign in and give Madison permission. This happens on the provider's own website (for example, Google's sign-in page), so your password is never shared with Madison. {% endstep %} {% step %} #### Assign accounts to your locations Once the integration is connected, go to **Settings → Locations**, open the relevant location, and select its **Integrations** button. From there, choose which accounts within that integration belong to this location. Madison starts syncing shortly after. {% endstep %} {% endstepper %} {% hint style="info" %} Some businesses manage more than one page or profile, so you can connect several accounts for the same service. {% endhint %} ## Integrations you connect by invite A few integrations can't be connected with a sign-in step. Instead of signing in, you grant access from inside your own account with the provider, by inviting an email address that Madison shows you. This applies to: * **Tripadvisor** * **Expedia** * **Booking.com** * **Toast** {% stepper %} {% step %} #### Select Connect In **Settings → Integrations**, find the service and select **Connect**. A window opens showing an email address with a button to copy it. This address is unique to your account, so use the one shown here rather than one from anywhere else. {% endstep %} {% step %} #### Invite that email on the provider Sign in to your account with the provider and add that email address as a user, giving it access to **all the locations you want Madison to manage** on your behalf. Some providers also need a specific permission level: see **Provider-specific permissions** below. {% endstep %} {% step %} #### Confirm, then contact us to finish Back in Madison, tick the box to confirm the invite has been sent, then select **Connect**. This last step isn't automatic: once you've added the user with the right access, email so the Madison team can complete the connection from our side and start the import. {% endstep %} {% endstepper %} ### Provider-specific permissions Most providers only need the invited user added with access to your locations. Some also need you to grant a specific permission level: | Provider | Permission to grant | | ----------- | -------------------------------------------------------------------------------- | | **Expedia** | The **Property User** permission, for every location you want Madison to manage. | {% hint style="info" %} Adding more locations later? Open the integration again and add the same email address to those locations with the provider. {% endhint %} ## Connecting Facebook and Instagram Facebook and Instagram are connected together through **Meta**, the company behind both. One connection brings in your Facebook Page *and* your Instagram account: your reviews, posts, comments, and messages. We recommend connecting through **Meta Business Suite**. It keeps Madison connected in the background for the long term, so you can set it up once and not think about it again. If you have trouble connecting through Meta Business Suite, Madison offers a **backup Facebook connection** that also brings in both Facebook and Instagram. It works just as well day to day, but it needs reconnecting more often, and when it does, you'll need to be signed in to Facebook to refresh it. So it's best to use the backup only if the Meta Business Suite connection won't work for you. ## Reconnecting If a connection drops, Madison alerts your Owner and Admins by email with a link to **Settings → Integrations**. From there, find the affected integration and select **Reconnect**. For the invite-based integrations above, first check that Madison's email address still has access on the provider, then email so the Madison team can restore the connection. ## Disconnecting an integration To remove a connection, go to **Settings → Integrations**, find the integration, and disconnect it. {% hint style="warning" %} Disconnecting removes all accounts within that integration and stops Madison syncing their data. Your existing data stays in Madison, but it won't update until you reconnect. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.meetmadison.ai/getting-started/connect-your-integrations.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.