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

# Sphere

## Overview

Integrating Salesbricks with Sphere enables a seamless data import from Salesbricks to Sphere, as well as live tax calculation within Salesbricks checkout & invoices.

This **two-part guide** provides step-by-step instructions on:

**1.** retrieving your Salesbricks API key and linking it to Sphere for a secure data sync

**2.** linking your Sphere Tax API key within Salesbricks to ensure accurate tax calculations

## Setup

### Part 1: Configure data synchronization from Salesbricks to Sphere

**1.** In your Sphere account, go to **Integrations**, select the **Salesbricks** tile and click **Connect**.

<Frame>
  <img src="https://mintcdn.com/salesbricks/RE-3ocRkRaNz5VNR/integrations/images/sphere/sphere-select-salesbricks.jpeg?fit=max&auto=format&n=RE-3ocRkRaNz5VNR&q=85&s=a5ab695712d051b4308541d011d4af01" alt="sphere-select-salesbricks" width="1920" height="992" data-path="integrations/images/sphere/sphere-select-salesbricks.jpeg" />
</Frame>

**2.** A modal will appear — click **Get Started** to proceed.

<Frame>
  <img src="https://mintcdn.com/salesbricks/RE-3ocRkRaNz5VNR/integrations/images/sphere/sphere-get-started.jpeg?fit=max&auto=format&n=RE-3ocRkRaNz5VNR&q=85&s=dbdaf1a4a6352920cb9ecc4e7100aefa" alt="sphere-get-started" width="1920" height="992" data-path="integrations/images/sphere/sphere-get-started.jpeg" />
</Frame>

**3.** In Salesbricks, navigate to <a href="https://app.salesbricks.com/admin/settings/integrations" target="_blank" rel="noopener noreferrer">Settings -> Integrations</a>. Under the **Billing and payment** section, click **Sphere**.

<Frame>
  <img src="https://mintcdn.com/salesbricks/RE-3ocRkRaNz5VNR/integrations/images/sphere/salesbricks-select-sphere.png?fit=max&auto=format&n=RE-3ocRkRaNz5VNR&q=85&s=979f5d0f263bed93b0bde8ac0218a50f" alt="salesbricks-select-sphere" width="2598" height="2011" data-path="integrations/images/sphere/salesbricks-select-sphere.png" />
</Frame>

**4.** Copy your **Salesbricks public API key** to your clipboard.

<Frame>
  <img src="https://mintcdn.com/salesbricks/RE-3ocRkRaNz5VNR/integrations/images/sphere/salesbricks-copy-key.png?fit=max&auto=format&n=RE-3ocRkRaNz5VNR&q=85&s=73852f1a3050892e11f2f9c76d99669a" alt="salesbricks-copy-key" width="2541" height="1086" data-path="integrations/images/sphere/salesbricks-copy-key.png" />
</Frame>

**5.** In Sphere, paste the Salesbricks API key and click **Next**.

<Frame>
  <img src="https://mintcdn.com/salesbricks/RE-3ocRkRaNz5VNR/integrations/images/sphere/sphere-paste-salesbricks-key.jpeg?fit=max&auto=format&n=RE-3ocRkRaNz5VNR&q=85&s=ce1e13913f9f0f909af554c95bd721fa" alt="sphere-paste-salesbricks-key" width="1920" height="992" data-path="integrations/images/sphere/sphere-paste-salesbricks-key.jpeg" />
</Frame>

**6.** If the connection is successful, data will begin importing, and after some time, your plans and bricks will appear in **Sphere**.

<Frame>
  <img src="https://mintcdn.com/salesbricks/RE-3ocRkRaNz5VNR/integrations/images/sphere/sphere-data-import.jpeg?fit=max&auto=format&n=RE-3ocRkRaNz5VNR&q=85&s=d6c2a25e5a48b146795ac297af8cc338" alt="sphere-data-import" width="1920" height="992" data-path="integrations/images/sphere/sphere-data-import.jpeg" />
</Frame>

<Warning>
  **Continue on to part 2 of the setup below to ensure that the integration is fully set up, and tax is applied correctly to Salesbricks orders.**
</Warning>

### Part 2: Configure Sphere Tax API key for tax calculation

**1.** In Sphere, click **Generate API Key** to generate the Sphere Tax API key. Be sure to save the newly generated key, as it cannot be viewed again later.

<Frame>
  <img src="https://mintcdn.com/salesbricks/RE-3ocRkRaNz5VNR/integrations/images/sphere/sphere-generate-key.jpeg?fit=max&auto=format&n=RE-3ocRkRaNz5VNR&q=85&s=25559495e2c91aa45a590ffbdc3bf8b0" alt="sphere-generate-key" width="1920" height="992" data-path="integrations/images/sphere/sphere-generate-key.jpeg" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/salesbricks/RE-3ocRkRaNz5VNR/integrations/images/sphere/sphere-copy-key.jpeg?fit=max&auto=format&n=RE-3ocRkRaNz5VNR&q=85&s=4e3cbfe6f9e3c33945f28f4c26fee367" alt="sphere-copy-key" width="1920" height="992" data-path="integrations/images/sphere/sphere-copy-key.jpeg" />
</Frame>

**2.** In Salesbricks, return to the Sphere integration page, paste your Sphere Tax API key, and click **Validate**.

<Frame>
  <img src="https://mintcdn.com/salesbricks/RE-3ocRkRaNz5VNR/integrations/images/sphere/salesbricks-paste-sphere-key.png?fit=max&auto=format&n=RE-3ocRkRaNz5VNR&q=85&s=8a1cd8e9751c0f9fff6f314fc8ee018b" alt="salesbricks-paste-sphere-key" width="2541" height="1086" data-path="integrations/images/sphere/salesbricks-paste-sphere-key.png" />
</Frame>

Once configured, taxes will be calculated automatically on orders and invoices in Salesbricks.

<Frame>
  <img src="https://mintcdn.com/salesbricks/RE-3ocRkRaNz5VNR/integrations/images/sphere/integration-details.jpeg?fit=max&auto=format&n=RE-3ocRkRaNz5VNR&q=85&s=47a580b8d796df1326ba7350075e41ab" alt="integration-details" width="1920" height="992" data-path="integrations/images/sphere/integration-details.jpeg" />
</Frame>

<Warning>
  Enabling your Sphere integration will disable any previously selected “taxed states” under <a href="https://app.salesbricks.com/admin/settings/finance" target="_blank" rel="noopener noreferrer">Settings → Finance</a>, as well as any custom tax codes for bricks that were previously set in Salesbricks.
</Warning>