# Connect Walmart: create an API key

> Add your Walmart countries, then create a client ID and secret in Walmart's Developer Portal for each one and paste them on the country's channel page. About 10 minutes.

Category: Marketplaces · Web page: https://bookalyze.com/guides/connect-walmart

## Before you start

Walmart's US, Canada and Mexico seller accounts are separate, so each country is its own channel with **its own key**. Connect only the countries you sell in.

**Where in Bookalyze:** Commerce → Channels → Add a channel → Walmart

1. **Add the country.** Choose the United States, Canada or Mexico.
2. **Say who ships.** Walmart Fulfillment Services (WFS), you, or both. Bookalyze reads the matching order lists, and WFS stock when Walmart ships.

## Create the key in Walmart's Developer Portal

1. **Sign in to the Developer Portal.** Go to **developer.walmart.com** and sign in with the same login as your **Seller Center** account for that country.
2. **Open API key management.** Add a new key (or use an existing one) for your own account.
3. **Give it access to three areas.** **Orders**, **Reports** and **Inventory**. View only is enough: Bookalyze never changes anything on Walmart.
4. **Copy the client ID and client secret.** The secret is shown when the key is made. Keep it like a password.

## Paste it into Bookalyze

**Where in Bookalyze:** Commerce → Channels → (your Walmart country) → Walmart account → Connect Walmart

Bookalyze gets a token from Walmart with the key, asks Walmart what the key can see, and saves it encrypted. Anything missing gets a warning: give the key that access in the portal and choose **Test connection**.

What you should see:
- [ ] The country shows **Connected**, with "Key ending …" (the last four characters)
- [ ] Orders, Reports and Inventory each show the access you gave
- [ ] On Commerce → Orders, the country's orders start to arrive
- [ ] On the channel's **Walmart settlements** card, **Bring in from Walmart** brings in Walmart's settlement reports

## Replacing or removing the key

- **Replace key** takes a new client ID and secret, for example after you rotate it in the portal.
- **Disconnect** deletes the key from Bookalyze. The channel keeps its orders, settlements and history.

## Related guides

- [Walmart settlements: bring in, check, post](https://bookalyze.com/guides/walmart-settlements.md): Walmart's settlement reports come in row by row. Bookalyze adds them up to Walmart's payout, posts only the ones that do, and posts a settlement again when Walmart corrects it.
- [Stock in one place: your books against Amazon, Noon, Walmart and your count](https://bookalyze.com/guides/stock-overview.md): One row per product: units in your books, what Amazon, Noon and Walmart hold, what you counted yourself, and the difference.
- [Channels: switch off, say who ships, remove, disconnect](https://bookalyze.com/guides/channels.md): Every Amazon marketplace, Walmart country, Noon country and eBay site is a channel in its own currency. Switch one off, say who ships its orders, remove one added by mistake, or disconnect an account.