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

# Connect Birdeye

> Read surveys, reviews, and locations — read-only for now.

Connecting Birdeye lets Rivvi read your survey list, recent responses, public reviews, and location roster from chat. This first version is **read-only** — it does not send survey or review-request messages.

You connect by pasting your **Birdeye API key** and **business ID**. There is no marketplace app to install.

## What you'll need

* **API key** — from your Birdeye dashboard (account settings → API)
* **Business ID** — the enterprise / parent business ID for the account

<Card title="Birdeye: API authentication" icon="arrow-up-right-from-square" href="https://docs.birdeye.com/api/authentication" />

## Connect it

<Steps>
  <Step title="Copy your API key and business ID">
    In Birdeye, open account settings and copy the API key. Copy the business ID from the same account (or from Birdeye support if you only have a location ID).
  </Step>

  <Step title="Open Rivvi's connector settings">
    **Settings → Connectors**, select **Birdeye**, click **Connect**.
  </Step>

  <Step title="Paste your credentials">
    | Field           | What to paste              |
    | --------------- | -------------------------- |
    | **API key**     | Your Birdeye API key       |
    | **Business ID** | The enterprise business ID |
  </Step>
</Steps>

<Note>
  Birdeye survey responses and reviews can include patient names. Reads are **Always allow** by default; an admin can tighten this — see [Permissions](/connectors/permissions).
</Note>

## What Rivvi can do with Birdeye

**Read (allowed by default)**

* Read the connected business profile.
* List child locations.
* List surveys (ids, names, status, response counts).
* Read a page of responses for one survey.
* Read a page of reviews (rating, source, comment, location).

**Not in this version**

* Sending a survey or review-request SMS/email (Birdeye still owns those campaigns).
* Creating contacts or recording a check-in.

## Try it

```text theme={null}
List my Birdeye surveys.
Show recent reviews for this account.
What locations are under this Birdeye business?
```

## Next

<Card title="Connectors overview" icon="plug" href="/connectors/overview" />