Triggers & Actions
Complete reference for workflow triggers and available actions.
- Use this page as a reference when building workflows.
- Each trigger has specific conditions you can configure.
- Actions can be customized with templates and variables.
This is your complete reference for workflow triggers and actions. Use it when building workflows to understand all available options.
Triggers reference
Core monitoring triggers
visibility_changed
Fires when your overall visibility score changes beyond a threshold.
| Parameter | Type | Options |
|---|---|---|
| direction | select | increased, decreased, any |
| threshold | number | 1-100% change |
| model | select | any, specific model |
competitor_changed
Fires when a competitor's visibility changes significantly.
| Parameter | Type | Options |
|---|---|---|
| competitor | select | any, specific competitor |
| direction | select | gained, lost, any |
| threshold | number | 1-100% change |
rank_changed
Fires when your rank on a prompt changes.
| Parameter | Type | Options |
|---|---|---|
| direction | select | improved, dropped, any |
| prompt | multiselect | any, specific prompts |
| model | select | any, specific model |
perception_changed
Fires when your perception scores shift.
| Parameter | Type | Options |
|---|---|---|
| dimension | select | any, specific dimension |
| direction | select | improved, declined, any |
| threshold | number | 1-50 point change |
Discovery triggers
prompt_gap
Fires when a gap is identified in your prompt coverage.
| Parameter | Type | Options |
|---|---|---|
| gap_type | select | missing, underperforming, any |
| competitor | select | any, specific competitor |
citation_found
Fires when a new citation source is discovered.
| Parameter | Type | Options |
|---|---|---|
| sentiment | select | positive, negative, neutral, any |
| source_type | select | any, specific type |
opportunity_found
Fires when a new visibility opportunity is identified.
| Parameter | Type | Options |
|---|---|---|
| type | select | content, outreach, technical, any |
| priority | select | high, medium, low, any |
auditscoredropped
Fires when a page's audit score drops below a threshold.
| Parameter | Type | Options |
|---|---|---|
| threshold | number | 0-100 score |
| page | text | URL pattern to match |
Event triggers
research_completed
Fires when any research run completes.
| Parameter | Type | Options |
|---|---|---|
| type | select | manual, scheduled, any |
| brand | select | any, specific brand |
competitor_added
Fires when a new competitor is added to tracking.
| Parameter | Type | Options |
|---|---|---|
| brand | select | any, specific brand |
brand_created
Fires when a new brand is created in your account.
No configurable parameters.
Content triggers
article_generated
Fires when an article is generated by the content engine.
| Parameter | Type | Options |
|---|---|---|
| status | select | draft, published, any |
article_published
Fires when an article is published to a connected site.
| Parameter | Type | Options |
|---|---|---|
| site | select | any, specific site |
campaign_completed
Fires when a content campaign finishes.
| Parameter | Type | Options |
|---|---|---|
| campaign_type | select | any, specific type |
report_completed
Fires when a report finishes generating.
| Parameter | Type | Options |
|---|---|---|
| report_type | select | any, visibility, perception, competitive |
Time and AI Pages triggers
scheduled
Fires on a schedule you define (daily, weekly, monthly).
| Parameter | Type | Options |
|---|---|---|
| schedule | select | daily, weekly, monthly |
| day | select | (varies by schedule) |
| time | time | execution time |
crawler_spike
Fires when AI crawler visits exceed normal patterns.
| Parameter | Type | Options |
|---|---|---|
| multiplier | number | 2x, 3x, 5x normal |
| crawler | select | any, specific crawler |
Actions reference
Content generation actions
generate_article
Create an AI-optimized article based on trigger context.
| Parameter | Type | Required |
|---|---|---|
| topic | text (supports variables) | No (auto from trigger) |
| template | select | No |
| publish | boolean | No |
create_campaign
Launch a content campaign around the trigger topic.
| Parameter | Type | Required |
|---|---|---|
| campaign_type | select | Yes |
| article_count | number | No |
generate_summary
Generate an executive summary of trigger data.
| Parameter | Type | Required |
|---|---|---|
| format | select (brief, detailed) | No |
| recipients | email list | No |
generatepdfreport
Create a PDF report and email it to recipients.
| Parameter | Type | Required |
|---|---|---|
| report_type | select | Yes |
| recipients | email list | Yes |
| branding | select (default, white-label) | No |
draftoutreachemail
Draft an outreach email to a citation source.
| Parameter | Type | Required |
|---|---|---|
| tone | select (professional, casual) | No |
| template | select | No |
Tracking actions
addpromptto_tracking
Add a new prompt to your active tracking list.
| Parameter | Type | Required |
|---|---|---|
| prompt_text | text (supports variables) | Yes |
| tags | text list | No |
Notification actions
send_email
Send an email notification.
| Parameter | Type | Required |
|---|---|---|
| recipients | email list | Yes |
| subject | text (supports variables) | Yes |
| body_template | select | Yes |
| include_chart | boolean | No |
send_slack
Post to a Slack channel.
| Parameter | Type | Required |
|---|---|---|
| channel | text | Yes |
| message | text (supports variables) | Yes |
| mention | text | No |
send_teams
Post to a Microsoft Teams channel.
| Parameter | Type | Required |
|---|---|---|
| webhook_url | URL | Yes |
| message | text (supports variables) | Yes |
send_webhook
Send data to any URL.
| Parameter | Type | Required |
|---|---|---|
| url | URL | Yes |
| method | select (POST, PUT) | Yes |
| headers | key-value pairs | No |
| body | JSON (supports variables) | Yes |
Integration actions
publishtosite
Publish content to a connected CMS (WordPress, Webflow, Shopify).
| Parameter | Type | Required |
|---|---|---|
| site | select | Yes |
| status | select (draft, published) | No |
updategooglesheet
Add a row to a connected Google Sheet.
| Parameter | Type | Required |
|---|---|---|
| spreadsheet | select | Yes |
| sheet | text | No |
| columns | mapping | Yes |
create_task
Add an item to your task queue.
| Parameter | Type | Required |
|---|---|---|
| title | text (supports variables) | Yes |
| priority | select | No |
| assignee | user | No |
createnotionpage
Create a page in a connected Notion database.
| Parameter | Type | Required |
|---|---|---|
| database | select | Yes |
| properties | mapping | Yes |
CRM actions
sendtocrm
Send data to a generic CRM integration.
| Parameter | Type | Required |
|---|---|---|
| crm | select | Yes |
| record_type | select | Yes |
| fields | mapping | Yes |
sendtosalesforce
Create or update a Salesforce record.
| Parameter | Type | Required |
|---|---|---|
| object_type | select (Lead, Contact, Opportunity) | Yes |
| fields | mapping | Yes |
sendtohubspot
Create or update a HubSpot record.
| Parameter | Type | Required |
|---|---|---|
| object_type | select (Contact, Deal, Company) | Yes |
| fields | mapping | Yes |
Template variables
Use these in text fields:
| Variable | Value |
|---|---|
{{brand_name}} | Your brand name |
{{trigger_type}} | What triggered this |
{{trigger_summary}} | Human-readable summary |
{{visibility_score}} | Current visibility score |
{{visibility_change}} | Amount of change |
{{competitor_name}} | Competitor involved (if applicable) |
{{prompt_text}} | Prompt involved (if applicable) |
{{timestamp}} | When this fired |
{{dashboard_url}} | Link to your dashboard |
Example subject line:
[Trakkr] {{brand_name}} visibility {{trigger_summary}}
Becomes:
[Trakkr] Notion visibility dropped 12% this week
Next steps
Templates
Start with pre-built workflows.
Was this helpful?