Skip to main content
Tools as Triggers let you use the output of a Tool to trigger your Agent. This is useful when you need to combine data from multiple sources — like Salesforce and Airtable — to filter and process only the most relevant records before your Agent acts on them.
The Tool you use as a Trigger must return an array as its output.

​
Setting up a Tool Trigger

  1. Navigate to your Agent’s Triggers section and select Tool Trigger
  2. Name your Trigger — give it a clear name so you can identify it later
  3. Select the Tool you want to use as a trigger
  4. Click Continue
  5. Run a test of the Tool — this produces a sample output so you can configure what gets sent to your Agent
  6. Select the output field from the Tool’s results that you want to use as the Agent’s input
  7. Optionally, enable deduping (see below)
  8. Set a schedule — choose how often the Tool runs (daily, weekly, etc.) and the time
  9. Optionally, configure queue work hours if your plan supports it
  10. Click Setup to finish

​
Deduping

Deduping prevents duplicate messages from being added to your Agent’s queue. When enabled, you specify a field to use for deduplication. For example, if your Tool output includes a unique field like _id, messages with the same value in that field won’t be added to the queue more than once — regardless of whether the rest of the data has changed.

​
Common use cases

  • Pull new leads from a CRM and filter by criteria before triggering outreach
  • Combine data from multiple platforms into a single, filtered trigger
  • Process only records that meet specific conditions using custom Tool logic

​
Frequently asked questions (FAQs)

No. You can only set default values for the Tool’s inputs, which will be used every time the Trigger fires. Dynamic inputs per run are not supported.