Birdeye
Connect Birdeye to read and reply to reviews, see reputation reports by location, and manage listings, contacts, surveys and tickets.
You paste two values into PopMCP, both from one Birdeye page: the API key and the Business ID, under Settings, Integrations, API.
- Setup time
- 2 min
- Auth
- API credentials
- API base URL
- https://api.birdeye.com/resources
- Rate limits
- Set per API key and not published. Ask Birdeye support for your limit. Above it Birdeye answers 429.
Before you begin
- A Birdeye account with API access. If Birdeye answers that your key is not activated, Birdeye support or your rep can turn it on
- A sign-in that can open Settings in Birdeye, usually an account owner or admin
- If you have several locations, your main account's Business ID: its locations come with it
Get your credentials
Open the API page in Birdeye
Sign in to Birdeye, click Settings in the left rail, open Integrations, then choose API. On some older accounts the same details are under Account, then Developers.
API
No API key yet
Generate a key to use the Birdeye API.
Copy the API key and the Business ID
If a key is already there, use it. If not, click Generate API key. Copy the API key, then the Business ID, the long number shown with it. If you have several locations, use the number from your main account, not one location.
API
Paste both into PopMCP
In PopMCP, paste them into API key and Business ID and connect. PopMCP checks them with Birdeye and shows your business name. Under More options you can add the email you sign in to Birdeye with: some insight reports and ticket comments ask who is asking.
Connect in PopMCP
Open your workspace, choose Birdeye in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| API keysecret | In Birdeye: Settings, Integrations, API. Copy the key, or choose Generate API key if there is none. Stored encrypted.Encrypted with AES-256-GCM on save and never shown again. |
| Business IDtext | The long number on the same page as the key. If you have several locations, use your main account's number: its locations come with it. |
| Your Birdeye sign-in emailtext | Optional. Some insight reports and ticket comments ask who is asking. |
PopMCP verifies the credential against Birdeye immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP marks the Birdeye connection Verified with your business's name. Asking the AI how your reviews are doing returns your ratings and reviews per site.
Troubleshooting
Birdeye says this API key is not activated
Why:
Fix: API access is not switched on for this key. Ask Birdeye support or your rep to turn it on, then connect again.
Birdeye refused this API key
Why:
Fix: The key was changed or not copied whole. Copy it again from Settings, Integrations, API.
Birdeye does not know the Business ID
Why:
Fix: Copy the Business ID from the same page as the key. It is a long number, and a key from one account cannot open another account's number.
Birdeye's rate limit was reached
Why:
Fix: Birdeye sets a limit per key and does not publish it. Wait a minute and try again, or ask Birdeye support what your limit is.
The AI sees fewer reviews than Birdeye shows
Why:
Fix: Birdeye returns only featured reviews unless asked for all. Ask the AI for all reviews, which it sends as statuses all.