> For the complete documentation index, see [llms.txt](https://themochi-app.gitbook.io/mochi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://themochi-app.gitbook.io/mochi-docs/getting-started/connect-instagram.md).

# Connect Instagram

**Time: 2 minutes**

This is the core integration. Once connected, your DMs flow into Mochi automatically — your team responds from Mochi, not the native Instagram app.

{% stepper %}
{% step %}

### Authorize Instagram

Click **Connect Instagram**. You'll be redirected to Instagram's authorization page.

**Before you authorize:**

* Make sure you're logged into the correct Instagram account
* The account **must be a Business or Creator account** (not Personal)
* Accept **all permissions** — Mochi needs message access to function

> **How to switch to a Business account:** Open Instagram → Settings → Account → Switch to Professional Account → Choose Business or Creator.
> {% endstep %}

{% step %}

### Confirm Connection

Once authorized, you'll see your Instagram username displayed in Mochi confirming the connection is active. Your existing DM conversations will begin syncing.
{% endstep %}
{% endstepper %}

## Exclude Private Conversations

Your team will see all incoming DMs by default. You probably have friends, family, or business partners you don't want in your setter's inbox.

**To exclude contacts:**

1. Go to **Settings → Socials** (or do this during onboarding)
2. Add usernames to your **Excluded Contacts** list
3. These conversations will never appear in Mochi

{% hint style="info" %}
**Privacy:** Excluded contacts are completely hidden from your team. Use this for personal relationships, business partners, or anyone whose messages aren't sales leads.
{% endhint %}

You can update your excluded contacts anytime in **Settings → Socials**.

## Troubleshooting

<details>

<summary>DMs not appearing?</summary>

* Verify the Instagram account is Business or Creator type
* Check that all permissions were accepted during authorization
* New messages sync in real-time; older conversations may take a few minutes

</details>

<details>

<summary>Wrong account connected?</summary>

* Go to **Settings → Socials** and disconnect, then reconnect with the correct account

</details>

## What's Next

Next, you'll unlock your account with your access code.


---

# 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://themochi-app.gitbook.io/mochi-docs/getting-started/connect-instagram.md?ask=<question>&goal=<endgoal>
```

`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.