# habits_create

> Create a new habit to track.

<!-- Source: https://docs.actuallycare.com/tools/habits/habits_create -->

Create a new habit to track. The checklist and trackers are seeded automatically from the habit_type (bible/gym/throwing/reading/custom). Returns the created habit with its id and display_id (H-####). Cadence defaults to 'daily'. After creating, use [`habits_log`](/tools/habits/habits_log) to mark progress for a day.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | Yes | Name of the habit (e.g. "Read My Bible", "Go to the Gym") |
| `habit_type` | enum | No | Habit type — seeds the default checklist + trackers (default: custom) · One of: `bible`, `gym`, `throwing`, `reading`, `custom` |
| `cadence` | enum | No | How often the habit recurs (default: daily) · One of: `daily`, `weekly`, `monthly` |
| `weekly_target` | number | No | For weekly cadence — target sessions per week (e.g. 4 for a gym habit) · Max: 7 · Min: 1 |
| `tagline` | string | No | A short reminder of the "why" behind the habit |
| `started_on` | string | No | The date the habit started (YYYY-MM-DD). Defaults to unset. (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |

## Example prompts

- "Add a new record under habits."

## 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.