# goals_create

> Create a goal for the authenticated user.

<!-- Source: https://docs.actuallycare.com/tools/goals/goals_create -->
<!-- Last updated: 2026-10-22 -->

Create a goal for the authenticated user. Every goal needs a name (it is the heading users see), a metric, a positive target_value, and a period. The five derived metrics have their progress calculated from live CRM data; use metric="manual" for a goal whose number nobody can count for you (e.g. "get my first subscriber") — that is the only metric for which you may pass current_value. The goal is always created FOR the caller: assigning a goal to another user is a web-app action, not an MCP one. Returns the created goal.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | Yes | Name of the goal, said the way a person would say it (e.g. "Get my first user to subscribe") |
| `metric` | enum | Yes | What the goal counts. Use "manual" when the number is not derivable from CRM data. · One of: `closings`, `gci`, `lead_conversions`, `appointments`, `listings_taken`, `manual` |
| `target_value` | number | Yes | The number to reach (dollars for gci, a count otherwise) · Min: 0.01 |
| `period_type` | enum | Yes | How long the goal runs · One of: `weekly`, `monthly`, `quarterly`, `annually`, `custom` |
| `period_start` | string | Yes | First day of the goal period (YYYY-MM-DD) (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `period_end` | string | Yes | Last day of the goal period (YYYY-MM-DD) (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `description` | string | No | Optional longer description (max 4000 characters) |
| `unit_label` | string | No | Optional unit shown beside the number (max 24 characters, e.g. "listings") |
| `current_value` | number | No | Starting value. ONLY valid when metric="manual" — for every other metric the value is calculated from live data and passing it is rejected. · Min: 0 |
| `started_on` | string | No | The date the goal was set (YYYY-MM-DD). Defaults to period_start. (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |

## Example prompts

- "Set a goal of 12 closings this quarter."
- "Make a manual goal to get my first newsletter subscriber by the end of the year."

## Safety

**Creates data.** Creates a new record in your CRM and may trigger notifications or webhooks. Running it twice creates a duplicate, so Claude runs it once per request.
