Beeminder

Connect over a personal auth token to manage Beeminder goals and datapoints, refresh goal graphs, read your profile, and issue charges through the Beeminder API v1.

12 actions available

An activity completes in another app, such as a finished task or a logged workout

Agent reads the value and timestamp for the completed activity

Agent calls Create Datapoint with a Request ID so retries stay safe

Agent confirms the datapoint landed on the intended goal

Agent calls Get Goal to read the safety buffer and urgency

Agent posts a status update when a goal is close to derailing

A person reviews any charge before the account payment method is touched

What This Integration Enables

The Beeminder connector lets agents keep goals in sync and read their risk. Agents read the user profile, list and fetch goals, create and update goals, and refresh a goal graph. They create single datapoints, batch-create many at once, list, update, and delete datapoints, and use a Request ID to make creates safe to retry. Charge User moves real money, in US dollars with a one dollar minimum, and offers a Dry Run to validate without processing. The connector supplies the read, log, and charge actions; the surrounding flow decides what to log automatically and what needs a person, especially where money is involved.

Without FlowRunner

Progress logged by hand Someone opens Beeminder and enters each datapoint after an activity

Retries risk duplicates A re-run of a script can log the same progress twice

Derailments noticed late The safety buffer runs out before anyone checks the goal

With FlowRunner

Progress logged in the flow The agent creates a datapoint the moment an activity completes

Retries stay safe A Request ID makes each create idempotent, so a retry never duplicates

Derailments surfaced early Safety buffer and urgency reads become alerts a person can act on

Use Case Scenarios

Automatic Progress Logging

When a task is completed in a task manager or a commit lands in a repository, the agent calls Create Datapoint against a Do More goal, passing a Request ID so a retry never logs the same completion twice. The routine logging flows straight through, and the goal stays current without anyone entering datapoints by hand.

Scheduled Batch Sync

On a schedule, the agent reads tracked activity from a spreadsheet or database, then calls Create Datapoints Batch to sync all entries onto a goal in a single request. Batching keeps a goal's history complete even when the source updates in bulk rather than one event at a time.

Derailment Alert

The agent calls Get Goal to read a goal's safety buffer and urgency, and when a goal is about to derail it posts an alert to a personal or team channel. The alert is a heads-up, not an action, so the person decides whether to log more progress, adjust the goal, or accept the pledge.

Human-in-Loop Highlight

Logging a datapoint is routine and reversible. Charging the account payment method is neither, because Charge User moves real money against a card on file. This is [human-in-the-loop](/concepts/human-in-the-loop/) at the boundary between tracking a goal and acting on its stakes: before any charge, the agent stops, assembles the amount, the note, and the goal it relates to, and routes to a person through their preferred channel. The message is specific: "This would charge the card on file $10 for the derailed reading goal. Process it, or run a Dry Run and hold?" The connector can validate a charge without processing it, and the agent uses that path by default. It logs progress and reads risk on its own; a person owns every movement of money.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via preferred channel

Human decides

Agent resumes with decision

Agent Capabilities

12 actions

User

Get User Retrieve the authenticated user profile, including timezone, urgency load, and whether payment info is out of date. Include Associations pulls full detail for every goal in one call.

Goals

List Goals List all of the account goals sorted by urgency, most at-risk first. Each goal returns its slug, title, type, units, bright red line, safety buffer, and pledge.
Get Goal Retrieve a single goal by slug, including its bright red line, safety buffer, pledge, and progress. Use it to read how close a goal is to derailing.
Create Goal Create a new goal. Requires a slug, title, goal type, and units, plus two of goal date, goal value, and rate; Beeminder computes the third.
Update Goal Update the mutable attributes of an existing goal, such as title, axis label, secrecy, and bright red line. Goal type cannot change after creation.
Refresh Goal Graph Force Beeminder to refetch any autodata for the goal and regenerate its graph image. Use conservatively, since regeneration is resource-intensive.

Datapoints

Create Datapoint Add a single datapoint to a goal. Only value is required. Supply a Request ID to make the call idempotent so retried automations never create a duplicate.
List Datapoints List the datapoints for a goal, with sorting by any datapoint attribute and a limit on the number returned.
Update Datapoint Update an existing datapoint value, timestamp, or comment by its ID. Only the fields you provide change.
Delete Datapoint Permanently delete a datapoint from a goal by its ID and return the deleted record.
Create Datapoints Batch Create many datapoints on a goal in one request. Pass an array of datapoint objects and receive the array of created datapoints.

Charges

Charge User Charge the account payment method on file. Amount is in US dollars with a one dollar minimum and a required note. Dry Run validates a charge without processing it. This moves real money.

Start building with Beeminder

$100 in credits. No card required. Connect in minutes.

Start Building Free Talk to us