Dashello API

Authentication

Every request to the API requires an API key sent as a Bearer token in the Authorization header. You generate API keys from your Dashello Settings → API Keys page.

How to authenticate

# Include your API key in the Authorization header
curl https://dashello.co/api/ingest/metric \
  -X POST \
  -H "Authorization: Bearer dash_abc123..." \
  -H "Content-Type: application/json" \
  -d '{ "metric": "revenue", "value": 12345 }'

Key format

All API keys start with dash_ followed by a unique string. Example: dash_a1b2c3d4e5f6.... You can create named keys for each integration (e.g. "QuickBooks", "Stripe") and revoke them individually.

Header format

Authorization: Bearer dash_your_api_key_here

Errors

The API returns standard HTTP status codes and a JSON error body:

# Example error response
{
  "error": "invalid_api_key",
  "message": "API key not found or revoked"
}

POST /ingest/metric

Push a single numerical value into a specific metric on your dashboard. This is the most common endpoint — use it for revenue, leads, costs, or any single number.

curl https://dashello.co/api/ingest/metric \
  -X POST \
  -H "Authorization: Bearer dash_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "metric": "revenue",
    "value": 123456.78,
    "source": "quickbooks",
    "timestamp": "2026-05-20T12:00:00Z",
    "metadata": { "currency": "USD" }
  }'

{
  "ok": true,
  "inboxed": false,
  "metric_id": "found",
  "previous_value": "$119,000.00",
  "new_value": "$123,456.78"
}

{
  "ok": true,
  "inboxed": true,
  "metric_id": null,
  "previous_value": null,
  "new_value": "123,456.78"
}

POST /ingest/batch

Push multiple metric values in a single request. Use this for efficiency when sending multiple data points at once.

curl https://dashello.co/api/ingest/batch \
  -X POST \
  -H "Authorization: Bearer dash_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "metrics": [
      { "metric": "revenue", "value": 50000, "source": "quickbooks" },
      { "metric": "expenses", "value": 32000, "source": "quickbooks" },
      { "metric": "profit", "value": 18000, "source": "quickbooks" }
    ]
  }'

{
  "ok": true,
  "results": [
    { "metric": "revenue", "status": "updated" },
    { "metric": "expenses", "status": "updated" },
    { "metric": "profit", "status": "inboxed" }
  ]
}

POST /ingest/data

Push any JSON data into your Dashello inbox. Unlike /ingest/metric, this endpoint accepts arbitrary objects, text, or complex data — invoices, contacts, leads, or any business object.

curl https://dashello.co/api/ingest/data \
  -X POST \
  -H "Authorization: Bearer dash_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "quickbooks",
    "data_type": "invoice",
    "invoice_id": "INV-1042",
    "customer": "Acme Corp",
    "total": 12500.00,
    "status": "paid",
    "due_date": "2026-06-01"
  }'

{
  "ok": true,
  "inboxed": true,
  "message": "Data received and stored in inbox"
}

POST /ingest/tasks

Push tasks directly into your Dashello Tasks page. Use this for importing tasks from project management tools like Asana, Trello, or Jira.

curl https://dashello.co/api/ingest/tasks \
  -X POST \
  -H "Authorization: Bearer dash_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "asana",
    "tasks": [
      { "text": "Review Q2 budget", "dueDate": "2026-06-15", "priority": true },
      { "text": "Update team on project status", "notes": "Include timeline changes" }
    ]
  }'

{
  "ok": true,
  "created": 2,
  "total": 17
}

Native App Integrations

Dashello offers native OAuth 2.0 integrations for QuickBooks, Stripe, HubSpot, JobTread, and Google Sheets. These integrations pull data from each platform automatically — no manual setup or API calls required beyond the initial connection. Connected apps appear in your Integrations page where you can browse data catalogs, assign data points to dashboard metrics, and trigger one-click syncs.

QuickBooks Integration

Connect QuickBooks Online to automatically sync your accounting data — P&L, balance sheet, invoices, bills, customers, accounts receivable, and more.

How to connect

Data catalog — 66 data points across 15 groups

API endpoints used

Stripe Integration

Connect Stripe to track payments, subscriptions, MRR, churn, customers, invoices, payouts, and processing fees — all automatically synced to your dashboard.

How to connect

Data catalog — 64 data points across 9 groups

API endpoints used

HubSpot Integration

Connect HubSpot CRM to sync contacts, deals, pipeline stages, companies, and engagement activity — calls, meetings, emails, notes, and tasks.

How to connect

Data catalog — 26 data points across 5 groups

API endpoints used

JobTread Integration

Connect JobTread to sync construction business metrics — active jobs, revenue, costs, gross profit, pipeline, accounts receivable, invoices, and job-level financials.

How to connect

Data catalog — 60+ data points across 9 groups

API endpoints used

Google Sheets Integration

Connect Google Sheets to pull live cell values into your Dashello dashboard. Map individual cells to metric boxes, and they update automatically.

How to connect

API endpoints used

Supported actions: connect, status, disconnect, search, add-by-url, list-spreadsheets, remove-spreadsheet, get-sheets, get-sheet-data, get-cell-value, map-cell, unmap-cell, list-mappings, refresh-cell.

Zapier / Make Integration

Connect Dashello to thousands of apps through Zapier or Make.com automation platforms. Use the API endpoints with your Dashello API key to push data from any trigger.

Zapier

Make.com

Dashello has a custom app on Make.com with 6 ready-to-use modules. Install it from the Make.com Developer Portal or use the HTTP module directly.

The Dashello Make app modules:

To set up a Make scenario, add a Dashello module, create a new connection by pasting your API key, and map the input fields from your trigger app.

For step-by-step setup instructions, see the Make.com Dashello App README.

Rate Limits

SDK Examples

No SDK is required — just HTTP. But here are ready-to-use snippets for common languages:

Node.js

const API_KEY = "dash_your_api_key";

async function pushMetric(name, value, source) {
  const res = await fetch("https://dashello.co/api/ingest/metric", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ metric: name, value, source }),
  });
  return res.json();
}

// Usage
await pushMetric("revenue", 50000, "quickbooks");

Python

import requests

API_KEY = "dash_your_api_key"

def push_metric(name, value, source="api"):
    res = requests.post(
        "https://dashello.co/api/ingest/metric",
        json={"metric": name, "value": value, "source": source},
        headers={"Authorization": f"Bearer {API_KEY}"}
    )
    return res.json()

# Usage
result = push_metric("leads", 47, "hubspot")
print(result)

curl

curl -X POST https://dashello.co/api/ingest/metric \
  -H "Authorization: Bearer dash_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"metric": "revenue", "value": 12345, "source": "api"}'

Google Apps Script

function pushToDashello(metric, value) {
  const API_KEY = "dash_your_api_key";
  const options = {
    method: "post",
    headers: { "Authorization": "Bearer " + API_KEY },
    contentType: "application/json",
    payload: JSON.stringify({ metric, value, source: "google-sheets" }),
  };
  UrlFetchApp.fetch("https://dashello.co/api/ingest/metric", options);
}

// Use in a sheet trigger
function onEdit(e) {
  pushToDashello("Sheet Updated", 1);
}