From 4f1c48313c5f21ec98c679b2f578c8a81e4f6d36 Mon Sep 17 00:00:00 2001
From: Manu <4445816+tr4nt0r@users.noreply.github.com>
Date: Wed, 5 Mar 2025 06:39:33 +0100
Subject: [PATCH] create_habit action (#37776)

---
 source/_integrations/habitica.markdown | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/source/_integrations/habitica.markdown b/source/_integrations/habitica.markdown
index 877cb5fc445..73231240cf7 100644
--- a/source/_integrations/habitica.markdown
+++ b/source/_integrations/habitica.markdown
@@ -328,6 +328,21 @@ Updates a specific habit for the selected Habitica character.
 | `counter_down` | yes      | Update the down counter of a negative habit.                                                 |
 | `alias`        | yes      | A task alias can be used instead of the name or task ID. Only dashes, underscores, and alphanumeric characters are supported. The task alias must be unique among all your tasks. |
 
+### Action `habitica.create_habit`
+
+Creates a habit for the selected Habitica character.
+
+| Data attribute | Optional | Description                                                                                  |
+| -------------- | -------- | -------------------------------------------------------------------------------------------- |
+| `config_entry` | no       | Select the Habitica account to create a habit.                                               |
+| `name`         | no       | The title for the Habitica habit.                                                            |
+| `notes`        | yes      | The notes for the Habitica habit.                                                            |
+| `up_down`      | yes      | Defines if the habit is good and rewarding (positive), bad and penalizing (negative) or both. Valid values: `up`, `down`, or `[up, down]` |
+| `priority`     | yes      | Sets the difficulty of the habit. Valid values: `trivial`, `easy`, `medium`, `hard`. Default: `easy` |
+| `frequency`    | yes      | Defines when the habit's counter resets. Valid values: `daily`, `weekly`, `monthly`. Default: `daily` |
+| `tag`          | yes      | Add tags to the Habitica habit. If a tag does not already exist, a new one will be created.  |
+| `alias`        | yes      | A task alias can be used instead of the name or task ID. Only dashes, underscores, and alphanumeric characters are supported. The task alias must be unique among all your tasks. |
+
 ## Automations
 
 Get started with these automation examples for Habitica, each featuring ready-to-use blueprints!