Create Datapoints

beeminder.create_datapoints
ActionBusiness appsconnection required

Calls the Beeminder API with the connection's credentials.

Add several datapoints to one goal in a single call and report which rows Beeminder accepted and which it refused.

Connection

Required
Yes — the node will not save without one
Auth type
API key
Providers
Beeminder
Secret shape
the personal auth token, or {"auth_token": "…"} / {"access_token": "…"}
Config it needs
username
Resolved by
config.connection_id, else node.connection_id

Configuration

2 fields, 2 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
goal
The goal's slug — the last segment of its Beeminder URL, e.g. 'weight'.
stringYes——weight
datapoints
The datapoints to add. Each row is an object with at least a numeric 'value', and may also carry timestamp, daystamp, comment and requestid.
arrayYes—≥ 1 characters; array of object[{"comment":"from Mantle","requestid":"run-1","value":1},{"daystamp":"20260910","value":2}]

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "datapoints": [
    {
      "comment": "from Mantle",
      "requestid": "run-1",
      "value": 1
    },
    {
      "daystamp": "20260910",
      "value": 2
    }
  ],
  "goal": "weight"
}

Output

One shape.

result

FieldTypeExample
datapoints
The datapoints Beeminder created.
array—
errors
One entry per row Beeminder refused, with its reason.
array—
requested
How many rows were sent.
number—
created
How many rows Beeminder created.
number—
partial
True when some rows were refused.
boolean—
{
  "created": 0,
  "datapoints": [],
  "errors": [],
  "partial": false,
  "requested": 0
}

See Create Datapoints run in a workflow.

In a technical demo we add the Beeminder connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.