diff --git a/apps/docs/automations.mdx b/apps/docs/automations.mdx
index eeff3f4bd..f96cbaa48 100644
--- a/apps/docs/automations.mdx
+++ b/apps/docs/automations.mdx
@@ -105,7 +105,9 @@ an explicit IANA timezone.
 
 Admins can also manage custom automations from a Roomote task through the
 `manage_custom_automations` tool: list, resolve a schedule, create, update,
-delete, or run an enabled automation immediately.
+delete, or run an enabled automation immediately. For `schedule`, use `off`,
+`every_hour`, `every_6_hours`, `daily`, or `weekly` for a built-in preset, or
+provide a five-field cron expression or natural-language recurring schedule.
 
 ## Channel automations