# Connect Noon: make a service account key file

> Create a service account in Noon's partner portal, download its .json key file, and choose it in Bookalyze. One key covers every Noon country.

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

## Add your Noon countries

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

Choose the UAE, Saudi Arabia or Egypt, and who ships the orders: **Fulfilled by Noon (FBN)**, **Fulfilled by you (FBP)**, or both. Add each country you sell in.

## Create the service account

1. **Open API users.** Sign in at **access.noon.partners**, then **User & Access → API Users**.
2. **Add Service Account.** Give it a name, and a role that can **download reports**, such as **Project Owner** or **Project Admin**.
3. **Leave the IP whitelist empty.** Bookalyze runs on servers without a fixed address, so a whitelist would block it.
4. **Download the key file.** Noon gives you a **.json** key file **once**. Save it somewhere safe; if it's lost, make a new service account.

## Choose the file in Bookalyze

**Where in Bookalyze:** Commerce → Channels → (a Noon country) → Noon's API → Connect Noon's API

The file is read in your browser and sent once. Bookalyze keeps only what it needs to sign in (the key ID, private key and project code), encrypted, and signs in to Noon to check it.

What you should see:
- [ ] Noon's API shows **Connected** with your project
- [ ] "N reports available, payouts included": the payouts report (the transaction view) is what posts Noon to your books
- [ ] On Commerce → Settlements → Noon, **Bring in from Noon** fetches a year of transactions

> **Caution:** If the key has no payouts report, Bookalyze warns you. Give the service account a role with finance access in Noon's portal, then choose **Test connection**.

## No API? Upload instead

Everything also works from files: download **Finance → Transaction view** (CSV) from Noon's seller portal and upload it on Commerce → Settlements → Noon. Connect the key whenever you're ready.

## Related guides

- [Noon: transactions, months and the balance check](https://bookalyze.com/guides/noon-months.md): Noon keeps a balance instead of sending settlements. Bookalyze brings in every row of Noon's transaction view, posts each country's month as one entry, matches each payment to your bank and checks your books agree with Noon.
- [Noon FBN stock: the ledger, the summary and the check](https://bookalyze.com/guides/noon-fbn-stock.md): Noon's FBN inventory ledger feeds cost of goods sold like Amazon's. Its summary shows what Noon holds, and Bookalyze checks the two reports agree.
- [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.