Dashello API

Authentication

Every request requires an API key sent as a Bearer token in the Authorization header. You generate API keys from your Dashello Settings 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,
  "metric_id": "m_abc123",
  "previous_value": "$119,000.00",
  "new_value": "$123,456.78"
}

{
  "ok": true,
  "inboxed": true,
  "message": "No metric matched 'revenue'. Data stored in inbox for mapping."
}

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", "message": "No matching metric found" }
  ]
}

POST /ingest/data

Push any JSON data into Dashello. Unlike /ingest/metric, this endpoint accepts arbitrary objects, text, or complex data. If you have defined source connector mappings, the data will be automatically distributed to the right metric boxes. Otherwise, it goes to your inbox for manual assignment.

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"
  }'

POST /ingest/tasks

Push tasks directly into your Dashello Tasks page. This is useful 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
}

Webhooks

Dashello can receive native webhooks from popular apps. Instead of polling or manually pushing data, you set up a webhook URL in the third-party app's settings, and Dashello receives events in real-time.

Each app has its own webhook URL pattern:

QuickBooks Integration

Connect QuickBooks to automatically sync your accounting data — revenue, expenses, invoices, and profit — directly into your Dashello dashboard.

Alternatively, use the direct API approach from your QuickBooks automation:

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

Stripe Integration

Connect Stripe to track payments, subscriptions, charges, and revenue metrics without any manual entry.

Stripe webhooks we support:

Set up the Stripe webhook endpoint in your Stripe Dashboard → Developers → Webhooks:

https://dashello.co/api/webhook/stripe?connector_id=your_connector_id

HubSpot Integration

Sync CRM activity — new contacts, deals, meetings, and pipeline changes — to your Dashello dashboard.

Supported subscription types:

Set up the HubSpot webhook:

https://dashello.co/api/webhook/hubspot?connector_id=your_connector_id

Zapier / Make Integration

Use Zapier or Make (formerly Integromat) to connect Dashello with thousands of apps. There's no Dashello-specific Zap yet, but you can use the Webhooks by Zapier or HTTP module in Make.

Zapier

Make (Integromat)

Use the HTTP module → "Make a request" with the same configuration as above. Set method to POST, URL to the ingest endpoint, and add the Authorization header.

URL: https://dashello.co/api/ingest/metric
Method: POST
Headers:
  Authorization: Bearer dash_your_api_key
  Content-Type: application/json
Body:
{
  "metric": "your_metric_name",
  "value": 12345,
  "source": "make"
}

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);
}