{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Max Tasks","projectTitle":"Frontline Documentation"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"max-tasks","__idx":0},"children":["Max Tasks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Max Tasks"]}," are automations that run inside the calling user's personal Max assistant. Two kinds:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scheduled (cron)"]}," — run on a schedule (for example a daily 8am brief). Set with a cron expression."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Event-based"]}," — fire when something happens in a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/max/connectors"},"children":["Max Connector"]}," (new Gmail message, calendar event starting, deal stage change, …). Set with a trigger slug from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /max/periodic-tasks/triggers"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A task is either scheduled or event-based, never both. Requires a USER API key."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User tasks (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/tasks"]},") — the account \"To-dos\" inbox."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Object-row tasks — tasks attached to a CRM record."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"notifications","__idx":1},"children":["Notifications"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When Max finishes a run, the agent's final text output is what gets sent on the selected notification channels (email, WhatsApp, Slack). You do ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," need to instruct Max to call a send-email or post-to-Slack tool for the report — the system dispatches the output according to the notify flags."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"integrations","__idx":2},"children":["Integrations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Max tasks run in a sandbox with access to CRM record types, custom tools, and system tools. They only see the connected integrations you explicitly select (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gmail"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["googlecalendar"]},"). Discover valid toolkit slugs with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /max/integrations"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"operations","__idx":3},"children":["Operations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["URLs use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["periodic-tasks"]},"; the product name is Max Tasks."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Verb"},"children":["Verb"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Path"},"children":["Path"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/max/periodic-tasks"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List (filters: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enabled"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/max/periodic-tasks"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create (cron ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["or"]}," trigger slug)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/max/periodic-tasks/triggers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Event triggers available for the caller's connectors"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/max/periodic-tasks/{id}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Detail"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/max/periodic-tasks/{id}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Replace the whole task (also how you enable/disable)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/max/periodic-tasks/{id}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/max/periodic-tasks/{id}/execute"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Run a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["scheduled"]}," task now (event tasks cannot)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Trigger config often needs a resource id (mailbox, calendar, spreadsheet). Resolve those with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["frontline integrations resources …"]}," — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/workspace-connectors"},"children":["Workspace Connectors"]}," and Integration Resources in the API Reference."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Full list in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/reference/openapi"},"children":["API Reference"]}]}," under the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Max Tasks"]}," tag."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cli","__idx":4},"children":["CLI"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"max tasks triggers --pretty\nmax tasks create \\\n  --name \"Morning brief\" \\\n  --instructions \"Summarize open deals and yesterday's meetings.\" \\\n  --cron \"0 8 * * 1-5\" \\\n  --integrations '[\"gmail\"]' \\\n  --notify-email true\nmax tasks list --enabled true\nmax tasks run <taskId>\n","lang":"bash"},"children":[]}]},"headings":[{"value":"Max Tasks","id":"max-tasks","depth":1},{"value":"Notifications","id":"notifications","depth":2},{"value":"Integrations","id":"integrations","depth":2},{"value":"Operations","id":"operations","depth":2},{"value":"CLI","id":"cli","depth":2}],"frontmatter":{"seo":{"title":"Max Tasks"}},"lastModified":"2026-10-02T13:31:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/concepts/max/tasks","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}