SaaSFlow
DevelopersAPIReferencedashboards

Create dashboard

Create a custom dashboard owned by the person, for example a board meeting view or a cash overview. Pick widgets from dashboard_widgets_list and add…

Authentication

Checking whether you're signed in…
POST
/companies/{companyId}/dashboards

Authorization

headerAuthorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

Path Parameters

companyId*string
Length1 <= length

Request Body

application/json
  1. body
name*string
Length1 <= length <= 100
entries*array<|>

Widgets and section headlines in reading order. Leave out x/y/w/h and SaaSFlow lays them out on the 12-column grid: each widget at its default size, left to right, a new row when the next one does not fit, headlines full width. Send all four to place an entry yourself.

Itemsitems <= 60

Response Body

Created

application/json
  1. response
id*string
name*string
position*number
right*string

The person's access: viewer reads, editor also changes name and layout, owner also deletes.

Value in"viewer""editor""owner"
entries?array<|>
url*string

Where the person opens it in the app.

lastUpdatedTime*string|null
Example Request
curl -X POST 'https://api.saasflow.com/companies/string/dashboards' \  -H 'Content-Type: application/json' \  -d '{  "name": "string",  "entries": [    {      "type": "text",      "text": "string"    }  ]}'
Example Response
{  "id": "string",  "name": "string",  "position": 0,  "right": "viewer",  "entries": [    {      "type": "text",      "id": "string",      "text": "string",      "subText": "string",      "x": 0,      "y": 0,      "w": 0,      "h": 0    }  ],  "url": "string",  "lastUpdatedTime": "string"}

List dashboards

List the custom dashboards shared with the person, with their access and the link to open each one. Entries are left out; dashboards_get has them.

Retrieve dashboard

Retrieve one dashboard with its entries: widget ids and section headlines with their grid position (x and w in columns of 12, y and h in rows).