> For the complete documentation index, see [llms.txt](https://docs.getsphere.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getsphere.com/features/integrations/prebuilt-connectors/nue-integration.md).

# Nue Integration

Integrating Nue with Sphere enables seamless transaction data import and live tax calculation within Nue.io quotes, orders, and invoices.  

This guide provides step-by-step instructions on generating an API key in Nue, linking it to Sphere for a secure integration.

It also covers configuring the Sphere Tax API within Nue.io to ensure accurate tax calculations.\
\
**Note:** If you are attempting to connect to a Nue sandbox, you will need to use a corresponding Sphere test organization.

### Part 1: Configure Data Synchronization from Nue.io to Sphere

1. In the Sphere account, click on the Connect button on the Nue tile. 

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2FFxRhV3eTcgmpRjbx9wn3%2FNue%20connected.png?alt=media&amp;token=660870e7-2d5c-410a-99fc-528676ec3870" alt=""><figcaption></figcaption></figure>

2. In another window, open your Nue.io dashboard and navigate to **System Settings** and click **API Keys**

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2F4cOMnt97vLixf8XlQxlt%2FGroup%201.png?alt=media&amp;token=08618aca-3945-45d7-bb2b-61fe562ea98d" alt=""><figcaption></figcaption></figure>

3. Click the **+ New API Key** button and select the **System Administrator** assigned role

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2FLYOh60pGVZ0A6PemaBr8%2FGroup%201%20(1).png?alt=media&amp;token=66272c5e-0df7-4183-9982-ce97a7d24238" alt=""><figcaption></figcaption></figure>

4. Once you click **Confirm** you will be able to see the API Key you created by clicking **Reveal**

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2F26JQDSljPMRI1D3FSPlr%2FScreenshot%202026-02-20%20at%203.39.27%E2%80%AFPM.png?alt=media&amp;token=3375099b-f528-46f3-8aee-34adb97446f2" alt=""><figcaption></figcaption></figure>

5. Go back to your Sphere account and enter the API Key. Click **Next** to complete the data synchronization setup.

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2FBZejMSAuvREdli0hbt54%2FNue_api.png?alt=media&amp;token=e2ed3697-a0dd-4780-b57d-c9be49bf5b75" alt=""><figcaption></figcaption></figure>

6. On the next step, you will be prompted to generate a Sphere API Key. Save this API Key for Part 2 below.

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2FNOfr7NXgr2uW6GTGyoeP%2FNue_generate.png?alt=media&amp;token=f0ac4b71-6f35-4c4c-8905-e71e7f405922" alt=""><figcaption></figcaption></figure>

### Part 2: Configure Sphere Tax API Key for Tax Calculation

1. Navigate to **Settings → Roles** in Nue and ensure relevant admin roles have the **Sphere integration** permission enabled.

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2F9J8mZAsXZsftFVlEfPh2%2Fimage.png?alt=media&amp;token=df8ff64f-cab7-4a13-a316-08725cf75478" alt="" width="375"><figcaption></figcaption></figure>

2. Navigate to Settings > Integration Overview > Sphere integration
   1. Locate the **Sphere** card; it will display as **Not Connected** for a fresh tenant.
3. Click on the Wrench to open configuration panel or go directly to Settings > Sphere
4. You will land on the **Connect to Sphere Tax** panel, which prompts for the API key and offers **Test** and **Activate** buttons.
5. **Enter and test Sphere API key**
   1. Paste the **Sphere API token** from Part 1 above into the token field
   2. Click **Test**:
      1. If the key is invalid, you’ll see an authentication error: “Integration authentication failed. Please verify API key.”
      2. Fix and re‑test until the connection succeeds.
6. After a successful test, click **Activate.**
   1. On success, the Sphere card status updates to **Connected/Active** and Nue will start routing tax calls to Sphere.