# Faire setup for PopMCP

You paste one value into PopMCP: your brand's access token from the Faire brand portal. PopMCP reads which brand it belongs to, so there is nothing else to fill in.

- Auth: API credentials
- Setup time: 2 min
- API base URL: https://www.faire.com/external-api/v2
- Credentials screen: https://www.faire.com/brand-portal
- Provider docs: https://developers.faire.com/docs

## Approval required before this works

You need a Faire brand account that Faire has approved. The access token then comes from your brand portal, or from Faire's integrations team if the portal does not offer it. When PopMCP's own Faire sign-in is switched on, a brand just signs in.

- Typical wait: Minutes when the portal offers the key. Faire publishes no figure for a token requested by email.
- Cost: Faire's documents list no fee for the API. Faire's usual commission on orders is unchanged.
- Blocked until approved: Without a brand account nothing can connect: Faire says it has no retailer API. Without a token the connection cannot start.
- Works meanwhile: PopMCP's other connectors work as usual while you wait for Faire.

## Before you begin

- A Faire brand account that Faire has approved. Faire has no API for retailer accounts
- Access to your brand's settings in the Faire brand portal, or the email address on the account if you need to ask Faire for the token

## Get your credentials

### 1. Open your Integrations settings

Sign in to your Faire brand portal (the link below) and open Settings, then Integrations. This needs your brand account, not a retailer account.

Screen: https://www.faire.com/brand-portal

### 2. Generate the key, or ask Faire for it

Generate an API key there and copy it. Faire's developer documents tell a single brand to make the token in the brand portal, but other integrators report that some brands do not see the option. If you do not, email `integrations.support@faire.com` from the email address on your Faire account, name your brand and ask for your API access token. Faire issues it to the brand.

Screen: https://developers.faire.com/docs

### 3. Paste it into PopMCP

In PopMCP open Faire in the marketplace, paste the token into Access token and click connect. PopMCP calls Faire's brand profile to check it, shows your brand's name and stores the token encrypted. The connection starts read-only, so nothing changes on Faire until an owner or admin allows write actions.

## Fields PopMCP asks for

- Access token (accessToken) [required]: In your Faire brand portal open Settings, then Integrations, and generate an API key. If you do not see that option, email integrations.support@faire.com from your Faire account's email and ask for your API access token. Stored encrypted.

## Verify

PopMCP marks the Faire connection Verified under your brand's name. Asking the AI which orders still need to ship returns your open orders with their items and ship dates.

## Troubleshooting

### "Faire did not accept this access token."

Cause: The token was cut short, has been replaced, or is not an API token.

Fix: Copy the whole key again from **Settings**, **Integrations** in the brand portal, or ask `integrations.support@faire.com` for a new one.

### "That does not look like a Faire access token."

Cause: Something other than the token was pasted, such as a link or a sentence.

Fix: Paste only the token. PopMCP never needs your Faire password.

### There is no way to generate a key in the brand portal

Cause: Faire does not show the option to every brand.

Fix: Email `integrations.support@faire.com` from the email address on your Faire account and ask for your API access token.

### A write tool is missing or refused

Cause: New connections start read-only.

Fix: Ask an owner or admin to allow write actions on the Faire connection in PopMCP.

### Stock looks wrong after an update

Cause: On hand and available are different numbers. Available is on hand minus what open orders hold, so a number that already excludes open orders has them subtracted twice if it is sent as on hand.

Fix: Ask the AI to set available stock when your number is what can still be sold, and on hand stock only when it is what is physically on the shelf.

### A stock or price update fails and nothing changes

Cause: By default one unknown SKU fails the whole batch.

Fix: Ask the AI to apply what it can with partial success. It reports the SKUs that were not applied.

---

Source: https://www.docs.popmcp.com/docs/integrations/faire/