Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.firebolt.io/llms.txt

Use this file to discover all available pages before exploring further.

Embeddable integration with Firebolt

Embeddable is a developer-first toolkit for building lightning-fast, fully-custom analytics directly inside your product. Its headless architecture lets you craft analytics that look and feel native, while product, data, and customer-facing teams can iterate on dashboards without engineering bottlenecks. When paired with Firebolt, Embeddable lets you serve interactive dashboards over huge datasets while keeping millisecond-level response times for your end-users.

Prerequisites

Embeddable is a managed SaaS platform, so most deployment tasks are handled for you. You’ll need:
Network policyEnsure the service account’s network policy allows ingress from the fixed Embeddable IP ranges.

Quick-start

1. Set up your Embeddable account

Follow the Quickstart Guide to set up your Embeddable workspace and local environment.

2. Connect Firebolt

Use the Connections API to connect Firebolt, obtaining your API key from the homepage of your Embeddable workspace.
// Example only — store Embeddable API keys and Firebolt credentials securely (env vars or a secrets manager), not in source control.
const apiKey = '<your API Key>';
const connectionName = 'firebolt-prod';
const baseUrl = 'https://api.<your-region>.embeddable.com';

const resp = await fetch(`${baseUrl}/api/v1/connections`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${apiKey}`,
  },
  body: JSON.stringify({
    name: connectionName,
    type: 'firebolt',
    credentials: {
      database: '<your Firebolt database name>',
      account: '<your account name>',
      engine_name: '<your Firebolt engine name>',
      id: '<your service account ID>',
      secret: '<your service account secret>',
    },
  }),
});

3. Define your data models

You can now define your data models in preparation for building customer-facing dashboards, and test these in the Data Playground tab of your Embeddable workspace.

Next steps

Congratulations! You’re now ready to model, visualize, and embed. Further reading