Skip to main content
Agents & Tasks

Task triggers: manual, schedule, on complete, and app events

Choose when a task runs: by hand, at set times, after another task, or when something happens in a connected app.

Written By Katja Danilina

Last updated About 1 month ago

A trigger starts a task. Choose the simplest trigger that fits the job, and use Run now to test the task before turning on automatic runs.

Manual

A manual task runs only when someone selects Run now. Use it for early testing, for work that needs a human decision before it starts, and for repeat jobs that happen at irregular times. Manual tasks are available on every plan.

Schedule

A scheduled task runs at a time you set: once, or hourly, daily, weekly, monthly, yearly, or on a custom interval.

  1. Create or edit a task. Under Trigger, choose Select a trigger.

  2. Select Schedule.

  3. Choose the frequency, time, and time zone. For a repeating task you can also set a start date and an end.

  4. Check the next run Mantle shows, add the trigger, and select Run now once before making the task active.

Check the time zone carefully: a schedule that looks right in your time zone may run on a different local date for a teammate. Avoid very frequent schedules unless the result changes often enough to justify the extra credits.

On Complete

An On Complete trigger starts a task after another task finishes. Use it to split a long workflow into clear steps, such as: collect recent feedback, then summarize the themes, then post a short leadership update. If an earlier step fails, check the run history before restarting the chain.

Connected-app event

An app trigger starts a task when something happens in a connected app, such as a new issue, email, message, or payment, depending on the integration.

  1. Connect the app in Settings → Integrations.

  2. While editing the task trigger, select the integration and the event.

  3. Add filters when available, such as a team, project, or account.

  4. Test with a safe event and confirm the right task starts once and posts to the expected channel.

Not every integration offers triggers. Its guide on docs.mantle.chat shows whether it has agent tools, triggers, or both.

Which trigger should I use?

  • Needs approval each time: Manual.

  • Should happen at a regular time: Schedule.

  • Is one step in a bigger workflow: On Complete.

  • Should react to another app: Connected-app event.

Scheduled and event-based triggers need a paid plan. Automatic runs use the task owner's credits.

Full guide: https://docs.mantle.chat/features/triggers