> ## Documentation Index
> Fetch the complete documentation index at: https://kb.mspprocess.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Licences and distributors

> Set Core's org-wide defaults, and let User Onboarding buy an extra licence seat at your distributor when a client has none free.

When a new starter needs a licence with no free seat, User Onboarding can buy one at your distributor.

<video controls preload="none" playsInline poster="/images/videos/licences-and-distributors.jpg" src="https://mintcdn.com/triggr/arzEeC0dwWyO5_rA/images/videos/licences-and-distributors.mp4?fit=max&auto=format&n=arzEeC0dwWyO5_rA&q=85&s=eaee22a4e8dab4e94176999f95b5a64c" />

Licences and distributors: choose your distributor, map a client and its licences, and turn on auto-buy (1:27).

## General settings

Go to **Settings > General**, change a setting and click Save changes. Default Microsoft connection and Default PSA come from the [Microsoft](https://kb.mspprocess.com/core/get-started/connect-microsoft-365.md#change-your-connection) and [PSA](https://kb.mspprocess.com/core/get-started/connect-your-psa.md#change-it-later) setups; clearing either stops the workflows that use it.

![The General settings card with Default Microsoft connection set to GDAP (Partner Center), Default PSA set to Halo PSA, Default distributor set to TD Synnex Stellr, the Auto-buy seats for all clients by default switch turned on, and a Save changes button.](https://mintcdn.com/triggr/MwzXHG3UWzFixdSz/images/core/licences-and-distributors/general-settings.png?fit=max\&auto=format\&n=MwzXHG3UWzFixdSz\&q=85\&s=404f92e41b3d3b1f06472db9d9926c61)

## Buy seats automatically

**1. Connect your distributor**

In Integrations, set up [Pax8](https://kb.mspprocess.com/integrations/pax8.md), [Sherweb](https://kb.mspprocess.com/integrations/sherweb.md) or [TD SYNNEX StreamOne Stellr](https://kb.mspprocess.com/integrations/td-synnex/stellr.md), then choose it as **Default distributor** in **Settings > General**.

**2. Link each client**

Open the client on Clients and click **Map** next to your distributor under Integrations.

![The Integrations section of a client panel listing Halo PSA, Mapped to Acme Corp, with an Edit mapping button, and TD Synnex Stellr, Not mapped, with a Map button.](https://mintcdn.com/triggr/MwzXHG3UWzFixdSz/images/core/licences-and-distributors/client-integrations.png?fit=max\&auto=format\&n=MwzXHG3UWzFixdSz\&q=85\&s=ca283720095d2e97680fb1a9bb3b4f92)

**3. Pick its customer record**

Core suggests the closest name. Click **Save mapping**. For many clients at once, use the Client mapping card on the distributor's integration page.

![The Map Acme Corp dialog: Pick the matching record in TD Synnex Stellr so workflows resolve this client correctly, with Acme Corp selected, a Reload list link, and Cancel and Save mapping buttons.](https://mintcdn.com/triggr/MwzXHG3UWzFixdSz/images/core/licences-and-distributors/map-dialog.png?fit=max\&auto=format\&n=MwzXHG3UWzFixdSz\&q=85\&s=483beb1a3ec4493c00853c433117bada)

**4. Map licences and turn on auto-buy**

Close the panel and open the client again, so Distributor licenses loads its subscriptions. Check the subscription Core picked for each licence, set **Auto-buy seats** and click Save changes. Not mapped — won't auto-buy means pick a subscription; Client not linked means do the previous step.

![The Distributor licenses section of a client panel with Auto-buy seats set to Use org default (On). Microsoft 365 Business Premium and Microsoft 365 Business Standard are Auto-buy ready and Exchange Online (Plan 1) is Mapped — save to enable, each with a TD Synnex Stellr subscription picked, above a Save changes button.](https://mintcdn.com/triggr/MwzXHG3UWzFixdSz/images/core/licences-and-distributors/distributor-licenses.png?fit=max\&auto=format\&n=MwzXHG3UWzFixdSz\&q=85\&s=6ec742b8c3adf19631f5ce7d23503a47)

The same Distributor licenses card is on User Onboarding's Execution config when you choose a client.

Only licences marked Auto-buy ready buy seats. The request's summary says Will buy 1 seat of *licence* at *distributor*; after any approval, Top Up Licence Seats adds one seat, waits up to 10 minutes for Microsoft 365 to show it, then Core assigns the licence. A failed purchase never stops onboarding, and with Log actions to the ticket on, the ticket says what happened. Seats on annual subscriptions can't be reduced until renewal.

## Troubleshooting

> [accordion] “… has no available licences (0 of N seats free)” with auto-buy on
>
> Check the licence shows Auto-buy ready and Auto-buy seats is On (or Use org default (On)), then submit again.

> [accordion] “Bought 1 seat of … but Microsoft hadn't shown it as free within 10 minutes”
>
> Assign the licence once the seat appears.

> [accordion] “Couldn't add a seat of … at …”
>
> Fix the reason given, then assign the licence by hand once a seat is free.

> [accordion] “A seat request for … may have gone through”
>
> Check the subscription in your distributor's portal before buying another seat.

> [accordion] Turning on Auto-buy seats for all clients by default asks “Turn on Auto-buy seats for every client?”
>
> Any client without its own setting may then have a seat added on its next onboarding. Set Auto-buy seats to Off on clients you want to exclude.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.