curl --request POST \
--url https://api.upstackdata.com/accounts/api/dashboard/views/from-preset \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-pixel-id: <api-key>' \
--data '
{
"name": "NC + Meta Pulse",
"widgets": [
{
"measure": "core.new_customer_roas",
"title": "NC ROAS"
},
{
"measure": "core.new_customer_mer",
"title": "NC MER"
},
{
"measure": "meta.cpm",
"title": "Meta CPM"
}
]
}
'{
"dashboardView": {
"pk": "VIEW#01K7C9D1E3F5G7H9J1K3M5N7P9",
"sk": "view",
"id": "01K7C9D1E3F5G7H9J1K3M5N7P9",
"pixelId": "5f1e6a4f-2b7c-4d1e-9a3f-8c6b2e0d4a71",
"type": "view",
"name": "NC + Meta Pulse",
"configuration": {
"attributionModel": "first_click",
"attributionWindow": 30,
"granularity": "day",
"dateRange": {
"start": "2026-09-12",
"end": "2026-10-12"
},
"filters": {
"compareDateRange": null,
"preset": "last30",
"comparePreset": "previousPeriod",
"isCompare": false,
"enableCompareDate": false
},
"grid": {
"maxWidth": 1200
},
"widgets": [
{
"id": "0c4e2a7b-91d3-4f5a-8b6c-2d7e9f1a3b5c",
"title": "NC ROAS",
"chartType": "sparkline",
"layout": {
"x": 0,
"y": 0,
"rows": 1,
"columns": 3,
"minColumns": 3,
"maxColumns": 3,
"minRows": 1,
"maxRows": 1,
"static": false
},
"dataConfig": {
"measures": [
"core.new_customer_roas"
],
"dimensions": [],
"filters": []
}
},
{
"id": "9d1e3f5a-7b9c-4d2e-8f0a-1b3c5d7e9f2a",
"title": "NC MER",
"chartType": "sparkline",
"layout": {
"x": 3,
"y": 0,
"rows": 1,
"columns": 3,
"minColumns": 3,
"maxColumns": 3,
"minRows": 1,
"maxRows": 1,
"static": false
},
"dataConfig": {
"measures": [
"core.new_customer_mer"
],
"dimensions": [],
"filters": []
}
},
{
"id": "4a6c8e0b-2d4f-4a6b-9c8d-0e2f4a6b8c1d",
"title": "Meta CPM",
"chartType": "sparkline",
"layout": {
"x": 6,
"y": 0,
"rows": 1,
"columns": 3,
"minColumns": 3,
"maxColumns": 3,
"minRows": 1,
"maxRows": 1,
"static": false
},
"dataConfig": {
"measures": [
"meta.cpm"
],
"dimensions": [],
"filters": []
}
}
]
},
"order": 0,
"createdAt": "2026-10-12T15:58:20.640Z",
"createdBy": "",
"updatedAt": "2026-10-12T15:58:20.640Z",
"updatedBy": ""
}
}{
"message": "<string>",
"errors": [
{
"message": "<string>",
"key": "<string>",
"path": [
"<string>"
]
}
]
}{
"message": "<string>",
"errors": [
{
"message": "<string>",
"key": "<string>",
"path": [
"<string>"
]
}
]
}{
"message": "<string>",
"errors": [
{
"message": "<string>",
"key": "<string>",
"path": [
"<string>"
]
}
]
}DASHBOARDS
Build a dashboard from a list of measures
Create a dashboard from a list of measure ids. The server lays out KPI sparkline tiles four per row and fills in attribution, granularity, and date range defaults.
POST
/
accounts
/
api
/
dashboard
/
views
/
from-preset
curl --request POST \
--url https://api.upstackdata.com/accounts/api/dashboard/views/from-preset \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-pixel-id: <api-key>' \
--data '
{
"name": "NC + Meta Pulse",
"widgets": [
{
"measure": "core.new_customer_roas",
"title": "NC ROAS"
},
{
"measure": "core.new_customer_mer",
"title": "NC MER"
},
{
"measure": "meta.cpm",
"title": "Meta CPM"
}
]
}
'{
"dashboardView": {
"pk": "VIEW#01K7C9D1E3F5G7H9J1K3M5N7P9",
"sk": "view",
"id": "01K7C9D1E3F5G7H9J1K3M5N7P9",
"pixelId": "5f1e6a4f-2b7c-4d1e-9a3f-8c6b2e0d4a71",
"type": "view",
"name": "NC + Meta Pulse",
"configuration": {
"attributionModel": "first_click",
"attributionWindow": 30,
"granularity": "day",
"dateRange": {
"start": "2026-09-12",
"end": "2026-10-12"
},
"filters": {
"compareDateRange": null,
"preset": "last30",
"comparePreset": "previousPeriod",
"isCompare": false,
"enableCompareDate": false
},
"grid": {
"maxWidth": 1200
},
"widgets": [
{
"id": "0c4e2a7b-91d3-4f5a-8b6c-2d7e9f1a3b5c",
"title": "NC ROAS",
"chartType": "sparkline",
"layout": {
"x": 0,
"y": 0,
"rows": 1,
"columns": 3,
"minColumns": 3,
"maxColumns": 3,
"minRows": 1,
"maxRows": 1,
"static": false
},
"dataConfig": {
"measures": [
"core.new_customer_roas"
],
"dimensions": [],
"filters": []
}
},
{
"id": "9d1e3f5a-7b9c-4d2e-8f0a-1b3c5d7e9f2a",
"title": "NC MER",
"chartType": "sparkline",
"layout": {
"x": 3,
"y": 0,
"rows": 1,
"columns": 3,
"minColumns": 3,
"maxColumns": 3,
"minRows": 1,
"maxRows": 1,
"static": false
},
"dataConfig": {
"measures": [
"core.new_customer_mer"
],
"dimensions": [],
"filters": []
}
},
{
"id": "4a6c8e0b-2d4f-4a6b-9c8d-0e2f4a6b8c1d",
"title": "Meta CPM",
"chartType": "sparkline",
"layout": {
"x": 6,
"y": 0,
"rows": 1,
"columns": 3,
"minColumns": 3,
"maxColumns": 3,
"minRows": 1,
"maxRows": 1,
"static": false
},
"dataConfig": {
"measures": [
"meta.cpm"
],
"dimensions": [],
"filters": []
}
}
]
},
"order": 0,
"createdAt": "2026-10-12T15:58:20.640Z",
"createdBy": "",
"updatedAt": "2026-10-12T15:58:20.640Z",
"updatedBy": ""
}
}{
"message": "<string>",
"errors": [
{
"message": "<string>",
"key": "<string>",
"path": [
"<string>"
]
}
]
}{
"message": "<string>",
"errors": [
{
"message": "<string>",
"key": "<string>",
"path": [
"<string>"
]
}
]
}{
"message": "<string>",
"errors": [
{
"message": "<string>",
"key": "<string>",
"path": [
"<string>"
]
}
]
}Required scope:
dashboards:write
The quickest way to make a dashboard from a script or an AI agent: pass the measures
you want (“NC ROAS, NC MER, and Meta CPM”) and get back a finished view that opens in
the web app. The upstack dashboard view build CLI
command wraps this endpoint.
Layout
- Widgets default to
sparkline. Each sparkline is 3 columns wide and 1 row tall, and they fill rows of four in array order. - Any other
chartTypegets a full-width tile (12 columns, 4 rows) stacked below all the sparklines, in array order. - The view has a flat widget list and no sections. Rearrange it later in the web app or with Update a dashboard view.
Defaults
| Field | Default when omitted |
|---|---|
type | view |
attribution.model | first_click |
attribution.window | 30 |
granularity | day |
dateRange | 30 days ago through today (UTC) |
widget chartType | sparkline |
widget title | the measure id |
order is always 0.
Validation
- Measure ids aren’t checked against the catalog. A typo is saved as a widget for a
measure that doesn’t exist, so confirm ids with
List available measures first.
The same call returns each measure’s
shortTitle, which makes a goodtitle. - Titles are capped at 200 characters and
nameat 200. - Every call creates a new view, even with a name that already exists.
Related
- Create a dashboard view when you need exact widget positions or sections.
- Get a dashboard view to read the result back.
Authorizations
Your Upstack API key. Starts with upstack_.
The pixel id the request targets.
Body
application/json
Display name for the new view. Names don't have to be unique.
Required string length:
1 - 200One entry per widget. Sparkline tiles fill rows of four in array order; other chart types stack below all the sparklines, full width, also in array order.
Minimum array length:
1Show child attributes
Show child attributes
Defaults to view.
Available options:
view, attribution_view, pnl_view Auto-layout strategy. Default kpi-grid.
Available options:
kpi-grid Attribution defaults saved with the view.
Show child attributes
Show child attributes
Defaults to day.
Available options:
none, second, minute, hour, day, week, month, quarter, year Defaults to 30 days ago through today (UTC).
Show child attributes
Show child attributes
Response
The created view.
Show child attributes
Show child attributes
Was this page helpful?