Campfire Integration

Integrating Campfire with Sphere enables a.) seamless transaction data import and b.) live tax calculation within Campfire invoices.

This guide provides step-by-step instructions on generating an API key in Campfire, 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 Campfire to ensure accurate tax calculations.

Part 1: Configure Data Synchronization from Campfire to Sphere

Follow the steps below to get started:

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

1. In another window, open your Campfire Dashboard and navigate to the Settings tab. Click API Keys under the Developer section.

1. In the API Keys section, click Create API Key to generate a new key.

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

1. Click Save to complete the setup. A success message will confirm the connection.

2. Next, you'll proceed with setting up the webhook. Copy the Campfire Webhook URL.

1. Return to the Campfire Dashboard, go to the Settings tab in the left menu, and click Webhooks.

1. Create a new webhook and paste the URL you copied from Step 6. Ensure the "Active" checkbox is selected, enable all invoice-related topics from the list, and click "Save" when finished.

   Enabled topics:

   • Invoice.created

   • Invoice.updated

   • Invoice.deleted

   • Invoice.payment

   • Invoice.paid

1. Once the webhook is enabled, copy the HMAC-SHA256 secret in this step.

1. Go back to your Sphere account. In the Campfire Webhook Secret input field, paste the Signing Secret copied in Part 9, then click Save.

1. You’re all set! If the connection is successful, data will begin importing, and after some time, your products will appear in Sphere. You'll then need to assign tax codes to each of your products and tax will automatically populate on invoices in regions you are registered and where you've enabled automatic tax calculation.

Part 2: Create a Sphere Tax API Key for Tax Calculation

Note: Currently, the Campfire app does not have a field to input the Sphere API key. To set it up, the API key must be shared with the Campfire team.

1. Click the "Edit" button on the Campfire integration card to make changes.

1. This will open a modal displaying the integration details. Click "Generate API Key" to create a new key.

1. Follow the steps to create a new API key.

1. Make sure to store the newly generated key securely, as you won’t be able to view it again later.

1. This step is optional; you can revoke an existing key and generate a new one if necessary.