# Beeminder

Beeminder is an online goal-tracking service that uses financial incentives—pledge money on your objectives and forfeit it if you don’t keep up—to help you achieve your goals.

- **Category:** task management
- **Auth:** API_KEY, OAUTH2
- **Composio Managed App Available?** No
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `BEEMINDER`
- **Version:** 20260227_00

## Tools

### Authenticate and Redirect User

**Slug:** `BEEMINDER_AUTHENTICATE_AND_REDIRECT_USER`

Tool to authenticate a user and redirect them to a given URL. Use when sending a user into the Beeminder web UI directly after OAuth or token validation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `username` | string | No | Beeminder username or 'me' to refer to the authenticated user |
| `redirect_to_url` | string | Yes | Fully qualified URL to redirect the user to after successful authentication. Must be URL-encoded. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Charge

**Slug:** `BEEMINDER_CREATE_CHARGE`

Tool to create a new charge for a user. Use when billing a user outside of goal pledges; supports dryrun mode.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `note` | string | No | Explanation for why the charge is made |
| `amount` | number | Yes | Amount to charge the user, in USD. Minimum is $1.00 |
| `dryrun` | boolean | No | If true, returns the charge JSON without creating the charge |
| `user_id` | string | Yes | Beeminder username of the user to charge |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get all goals

**Slug:** `BEEMINDER_GET_ALL_GOALS`

Tool to retrieve all goals for a specified user. Use when listing a user's active goals.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `username` | string | Yes | Beeminder username whose goals to retrieve. Use 'me' for the authenticated user. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Archived Goals

**Slug:** `BEEMINDER_GET_ARCHIVED_GOALS`

Tool to retrieve archived goals for a specified user. Use when you need to inspect a user's past archived goals.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `username` | string | Yes | Beeminder username whose archived goals to retrieve. Use 'me' for the authenticated user. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Beeminder User Information

**Slug:** `BEEMINDER_GET_USER_INFORMATION`

Tool to retrieve information about a specified Beeminder user. Use when you need to fetch details like timezone, goals, urgency, or deleted goals after authenticating successfully.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skinny` | boolean | No | When used with diff_since, return slim goal attributes and only the most recent datapoint for each goal. |
| `username` | string | Yes | Beeminder username to retrieve information for. |
| `diff_since` | integer | No | Unix timestamp in seconds; return only goals and datapoints created or updated since this time. |
| `associations` | boolean | No | Whether to include full goal and datapoint objects instead of only slugs. |
| `datapoints_count` | integer | No | Number of most recent datapoints to return for each goal. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |