# Orb Integration Integrating Orb with Sphere enables a.) seamless transaction data import and b.) live tax calculation within Orb invoices. This guide provides step-by-step instructions on generating an API key in Orb, linking it to Sphere for a secure integration, and setting up a webhook connection between the two platforms. It also covers configuring the Sphere Tax API within Orb to ensure accurate tax calculations. ### Part 1: Configure Data Synchronization from Orb to Sphere **Note:** Ensure that the test mode flag is turned off in Orb and that you are in live mode. 1. In your Sphere account, click on the **Connect** button on the Orb tile.

2. In another window, open your Orb dashboard and navigate to the **Developers** tab. Click **API Keys**.

3. Click the **+ New API Key** button at the top.

4. A modal will appear allowing you to enter the **key name** and a **description**. Once finished, click **Create**.

5. A new key will be created. Be sure to save it, as you won’t be able to view it again.

6. Go back to your Sphere account and enter the API key generated in Step 4. Ensure there are no extra spaces before or after the value.

7. Click **Next** to complete the setup. A success message will confirm the connection. Next, you'll proceed with setting up the webhook. Copy the Orb Webhook URL.

8. Return to the **Orb Dashboard**, go to the **Developers** tab, and click **Webhooks**.

9. Click the **+ Add endpoint** button.

10. A modal will appear, prompting you to enter the **Endpoint URL** you copied from **Sphere** (Orb Webhook URL) in Step 7. Click **Add Endpoint**.

11. You will see the **Endpoint URL** successfully added to the list. Click the URL that was just added.

12. In the top right corner, expand the dropdown and click **View Signing Secret**.

13. Copy the **Signing Secret**. You will be pasting this value into **Sphere**.

14. Go back to the **Sphere dashboard**. In the **Orb Webhook Secret** input field, paste the **Signing Secret** copied in Part 13, then click **Done**.

15. You’re all set! If the connection is successful, data will begin importing, and after some time, your products will appear in **Sphere**.

### Part 2: Configure Sphere Tax API Key for Tax Calculation 1. Navigate to the settings in Orb and select the Integrations tab.

2. Locate Sphere tax in the Taxes section and click **"Connect Sphere"**.

3. In Sphere, click on "**Create a new API Key**" to generate the Sphere Tax API Key. Be sure to save the newly generated key, as it cannot be viewed again later.

4. Enter your Sphere Tax API Key into the text box and click **"Connect"**.

5. After completing the setup, the connection status will be set to **Active**.

*** ### Set up a connection between your Orb test account and Sphere To integrate your Orb test environment with Sphere, begin by enabling **test mode** in your Orb account. You can do this by toggling the switch located at the top of the Orb dashboard. **Note:** Before proceeding, please check with your Sphere representative to confirm that your Sphere test account is properly set up and aligned with your testing requirements. Once test mode is activated: * A **green notification bar** will appear across the top of the Orb dashboard, indicating that you are operating within the test environment. * All data and operations within this mode will remain isolated from your live/production Orb environment, ensuring a safe testing experience. After test mode is enabled, you can proceed to connect Sphere by following the same steps outlined above for production setup. For more information on using Orb’s test mode and environment setup, please refer to the official [Orb documentation](https://docs.withorb.com/quickstart/introduction).

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.getsphere.com/features/integrations/prebuilt-connectors/orb-integration.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.