# Yext setup for PopMCP You paste one value into PopMCP: the API key of a small app you make in Yext's Developer Console. PopMCP finds out whether your account is in the US or the EU, and if the key also reaches sub-accounts, you choose which to connect. - Auth: API credentials - Setup time: 3 min - API base URL: https://api.yextapis.com/v2 - Credentials screen: https://www.yext.com/users/login - Provider docs: https://docs.yext.com/docs/managementapis/introduction/overview-policies-and-conventions ## Before you begin - A Yext account, and access to its Developer Console. If Developer is not in your navigation bar, ask whoever administers your Yext account - No review or approval is needed for an app you make for your own account - A few tools need that product on your subscription: Live API and Content Endpoints, Search, Chat, Pages, Scout. Reseller agreements work for Yext partners only ## Get your credentials ### 1. Open the Developer Console Sign in to Yext. In the navigation bar, open Developer, then Developer Console. Every app in your account is listed here. Yext makes the key on an app, so PopMCP gets an app of its own. Screen: https://www.yext.com/users/login ### 2. Add an app Click + Add an App in the top right corner. Name it something you will recognise, like `PopMCP`, and click Create App. It stays private to your account, which is all this needs. Screen: https://www.yext.com/users/login ### 3. Choose what the app can do Open the API Credentials tab. Under API permissions, add each API you want the AI to use and set it to Read/Write, or Read-only to keep it from changing anything there. Most people want the entities, listings, reviews, social and analytics APIs. Click Save. Content Delivery APIs are always read only. You can add more later: they start working without reconnecting. Screen: https://www.yext.com/users/login ### 4. Copy the API key On the same tab, find the API Keys section. Click the eye icon to show the key, then copy it. The client ID and secret on the OAuth tab do not work here. Screen: https://www.yext.com/users/login ### 5. Paste the key into PopMCP and pick the account In PopMCP, paste the key into API key and connect. PopMCP tries it in Yext's US, EU and sandbox environments and lists the accounts it reaches: your own, plus any sub-accounts if it came from a parent account. Choose which to connect. Each goes to its own workspace and stays on that account. New connections start read-only until an owner or admin allows write actions. ## Fields PopMCP asks for - API key (apiKey) [required]: In Yext open Developer, then Developer Console and click + Add an App. Name it PopMCP and click Create App. On the API Credentials tab add the permissions you want and click Save, then click the eye icon beside the API key and copy it. Stored encrypted, used server-side only. ## Verify PopMCP marks the Yext connection Verified under your account's name, and names any common permission the app is missing. Asking the AI for an overview of your Yext account returns its locations, publishers and review average. ## Troubleshooting ### "Yext did not recognise this key in its US, EU or sandbox environments." Cause: The key was cut short, or it was copied from somewhere else on the page, or the app has since been deleted. Fix: In **Developer**, **Developer Console**, open the app, go to **API Credentials**, click the eye icon beside the API key and copy it again. ### "That does not look like a Yext API key." Cause: Something other than the key was pasted, such as a sentence, or the OAuth client ID or secret. Fix: Copy the value from the **API Keys** section of the app's **API Credentials** tab. ### A tool answers that this app has no permission for this API Cause: The API is not on the app, or it is only Read-only and the tool writes. Fix: On the app's **API Credentials** tab, add that API as **Read/Write** and click **Save**. It works straight away, with no reconnecting. ### The connection shows "Yext account" rather than your account's name Cause: The app has no Accounts permission, so PopMCP cannot read the name. Everything else still works. Fix: Add the Accounts permission on the app's **API Credentials** tab. ### "This Yext key cannot open account" Cause: The connection is on a sub-account the key no longer reaches. Fix: Use a key from that account or from its parent, then reconnect. ### A tool answers 404 for something you know exists Cause: The account may not have that product. Search, Chat, Pages, Scout and Content Delivery each need a subscription, and Agreements is for Yext partners. Fix: Check the product is on your subscription with your Yext account manager. ### Yext answers 429 Cause: An app gets 5,000 requests an hour, 1,000 for Analytics and for Agreements, and short bursts are limited separately. Fix: Wait as the message says. Summary tools such as `yext_get_account_overview` and `yext_summarize_reviews` use far fewer requests. --- Source: https://www.docs.popmcp.com/docs/integrations/yext/