Connect ILLIXIS to 6,000+ apps using Zapier. Automate your marketing workflows with real-time triggers and actions.


What You Can Do

Triggers (15)

Triggers fire when events happen in ILLIXIS and send data to other apps.

Trigger

When It Fires

Use Case

Brief Created

New brief completes

Notify Slack when strategy is ready

Content Generated

Article is written

Add to project tracker

Content Published

Content goes live on CMS

Tweet announcement, log to spreadsheet

Weekly Strategy Ready

Weekly plan is generated

Send email summary

Content Graded

Quality check completes

Track performance metrics

Quality Alert

Content scores D or F

Alert editor to review

Opportunity Created

New keyword opportunity found

Add to review queue

Opportunity Accepted

You approve an opportunity

Create brief, add to calendar

Decay Alert

Content performance drops

Create refresh task

Position Drop

Ranking falls 5+ positions

Alert team, investigate SERP

Quick Win Found

High-score arbitrage opportunity (60+)

Add to priority list

Social Published

Social post goes live

Cross-post to other platforms

Issue Detected

Content quality issue found

Create revision task

Critical Issue

High-severity issue found

Immediate Slack alert

Actions (10)

Actions let other apps do things in ILLIXIS.

Action

What It Does

Use Case

Create Brief

Generate new content brief

Create brief from Google Sheets row

Generate Content

Write article from brief

Auto-generate after manual approval

Publish Content

Push to WordPress/Shopify

Publish approved drafts

Schedule Publication

Schedule future publish

Queue content for later

Accept Opportunity

Approve keyword opportunity

Auto-accept high-score opportunities

Snooze Opportunity

Delay opportunity decision

Snooze low-priority items

Reject Opportunity

Archive opportunity

Auto-reject based on criteria

Create Social Post

Publish to social media

Share content across platforms

Searches (3)

Searches let you find specific records in ILLIXIS.

Search

What It Finds

Use Case

Search Briefs

Find briefs by keyword/title

Link existing brief to task

Search Content

Find articles by title

Reference existing content

Search Opportunities

Find opportunities by keyword

Check if opportunity exists


Setup

Step 1: Connect Your Account

  1. In Zapier, create a new Zap
  2. Search for "ILLIXIS" in the app selector
  3. Click "Connect a new account"
  4. You'll be redirected to ILLIXIS
  5. Click "Allow" to authorize Zapier
  6. Zapier receives access token automatically

Authentication: OAuth 2.0 with automatic token refresh. Tokens never expire unless you revoke access.

Step 2: Choose Your Trigger/Action

Select from 15 triggers, 10 actions, or 3 searches based on your workflow.

Step 3: Configure Settings

Each trigger/action has specific fields:

Example - Brief Created Trigger:

  • No configuration needed
  • Automatically fires when briefs complete
  • Includes: title, keyword, opportunity score, URL

Example - Publish Content Action:

  • Platform: wordpress, shopify, or default (uses tenant default)
  • Content ID: From previous step or search

Step 4: Test & Turn On

Test your Zap to verify data flow, then activate.


Common Workflows

1. Auto-Publish Approved Content

Trigger: Content Generated Filter: Grade = A or B Action: Publish Content (WordPress)

Automatically publish high-quality articles without manual review.


2. Slack Alerts for Position Drops

Trigger: Position Drop Action: Send Channel Message (Slack)

Message format:
```
Alert: {{content_title}} dropped {{position_change}} positions
Keyword: {{primary_keyword}}
View: {{content_url}}
```


3. Content Calendar Sync

Trigger: Brief Created
Action: Create Event (Google Calendar)

Add brief title as event with link to brief.


4. Quick Win Approval Workflow

Trigger: Quick Win Found
Filter: Arbitrage Score >= 80
Action: Accept Opportunity
Action: Create Brief

Auto-approve and generate briefs for exceptional opportunities.


5. Quality Control Pipeline

Trigger: Critical Issue
Action: Create Card (Trello)
Action: Assign (Trello)

Create review cards for high-severity content issues.


6. Social Media Amplification

Trigger: Content Published
Action: Create Tweet (Twitter via social publishing)
Action: Create Post (LinkedIn via social publishing)

Cross-promote published articles to social platforms.


7. Weekly Strategy Email

Trigger: Weekly Strategy Ready
Action: Send Email (Gmail)

Email yourself or your team when weekly recommendations are ready.


8. Google Sheets Logging

Trigger: Content Generated
Action: Create Row (Google Sheets)

Log every generated article with title, word count, grade, and link.


9. Content Decay Response

Trigger: Decay Alert
Action: Create Task (Asana)

Create refresh tasks when content performance declines.


10. Opportunity Pipeline

Trigger: Opportunity Created
Action: Create Row (Airtable)

Add all discovered opportunities to Airtable for team review.


How It Works

Instant Triggers (REST Hooks)

ILLIXIS uses REST Hooks for instant trigger delivery. No polling delays.

How it works:

  1. You activate a Zap with an ILLIXIS trigger
  2. Zapier subscribes to that event type
  3. ILLIXIS fires notifications in real-time when events occur
  4. Zapier processes immediately (typically < 1 second)

Deactivation:

  • Turn off a Zap → subscription is automatically removed
  • After 5 consecutive failures → subscription auto-disabled

Polling Fallback

If instant delivery fails, Zapier falls back to polling every 15 minutes.

/api/zapier/weekly-strategies/

GET

List weekly strategies

Rate Limits

  • Triggers: No rate limit (real-time webhooks)
  • Actions: 100 requests per minute per tenant
  • Searches: 100 requests per minute per tenant

Data Formats

Dates: ISO 8601 format (e.g., 2025-12-25T10:00:00Z)

Example payload (Brief Created):
```json
{
"id": 12345,
"title": "Complete Guide to SEO",
"target_keyword": "seo guide",
"source": "keyword",
"status": "completed",
"opportunity_score": 85,
"target_word_count": 2500,
"created_at": "2025-12-25T10:00:00Z",
"url": "https://app.illixis.io/briefs/12345/"
}
```


Manage Connections

View Active Zaps

Go to Settings → Integrations → Zapier to see:

  • Active webhook subscriptions
  • Trigger counts
  • Last triggered time
  • Failure tracking

Revoke Access

To disconnect Zapier entirely:

  1. Go to Settings → Integrations → Zapier
  2. Click "Revoke Access"
  3. All webhook subscriptions are deactivated
  4. Zapier can no longer access your account

Alternatively, delete OAuth tokens in Settings → API Access.

Troubleshooting

Zap not triggering:

  • Check subscription is active in Settings → Integrations
  • Verify event actually occurred in ILLIXIS (check brief/content status)
  • Check Zapier Zap history for errors
  • Webhooks auto-disable after 5 consecutive failures

Action failing:

  • Verify content/brief ID exists and belongs to your tenant
  • Check required fields are provided
  • For publishing: verify WordPress/Shopify connection is active
  • For social posts: verify social publishing account is connected

Authentication errors:

  • Reconnect your account in Zapier
  • Revoke and re-authorize if token issues persist

Security

Tenant Isolation

All Zapier requests are scoped to your tenant. You cannot access other tenants' data.

OAuth 2.0

  • PKCE-enhanced authorization flow
  • Automatic token refresh
  • Revokable at any time
  • No password sharing required

Webhook Verification

All webhooks include:

  • Unique subscription ID
  • Request timestamp
  • User-Agent header: ILLIXIS-Zapier/1.0

Data Transmitted

Zapier receives only:

  • Record IDs and public URLs
  • Titles, keywords, scores (no full content unless explicitly included)
  • Timestamps and status fields
  • No passwords, API keys, or sensitive credentials

Advanced Use Cases

Multi-Step Workflows

Example: Content Approval Pipeline

  1. Trigger: Content Generated
  2. Action: Send Slack message with approve/reject buttons
  3. Trigger: Webhook (from Slack button click)
  4. Action: Publish Content (if approved) OR Delete (if rejected)

Conditional Logic

Example: Smart Opportunity Routing

  1. Trigger: Opportunity Created
  2. Filter: Priority Score >= 70 AND Search Intent = Commercial
  3. Action: Accept Opportunity
  4. Action: Create Brief
  5. Action: Notify Slack (#high-priority channel)

Data Enrichment

Example: Enrich Briefs with External Data

  1. Trigger: Brief Created
  2. Action: Search (Airtable) - Find customer pain points
  3. Action: Search (Google Sheets) - Get product URLs
  4. Action: Update Brief (via API) - Add custom fields

Cross-Platform Sync

Example: Keep HubSpot in Sync

  1. Trigger: Content Published
  2. Action: Find Contact (HubSpot) - By domain
  3. Action: Create Note (HubSpot) - Log content URL
  4. Action: Update Contact (HubSpot) - Increment "content_count"

Performance Tips

1. Use Filters Early

Place Zapier filters immediately after triggers to reduce task usage.

Example:
```
Trigger: Content Generated
Filter: Grade = A OR Grade = B ← Add this before expensive actions
Action: Publish Content
```

2. Batch Search Operations

Instead of searching for each item individually, use Zapier's "Lookup Table" feature for common mappings.

3. Debounce Rapid Fires

Some triggers (like Content Published) are debounced internally (5-minute window) to prevent duplicate webhooks.

4. Use Digest Mode

For high-volume triggers (Issue Detected), use Zapier's "Digest" feature to batch events into hourly/daily summaries.


API Access for Developers

If you need custom integrations beyond Zapier:

Direct API Use

All Zapier endpoints are documented REST APIs. Use them directly with your OAuth token.

Example (cURL):
```bash
curl -X GET https://app.illixis.io/api/zapier/briefs/ \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

OAuth Application Setup

Create your own OAuth application in Settings → API Access to get client credentials for custom integrations.


Limits & Quotas

Item

Limit

Notes

Active subscriptions per tenant

Unlimited

Auto-cleanup after 90 days inactive

Webhook delivery timeout

30 seconds

Retries 3x with exponential backoff

Consecutive failures before auto-disable

5

Reactivate by turning Zap on again

Polling frequency

Every 15 minutes

Fallback if REST Hooks fail

Action rate limit

100/min

Per tenant

Search rate limit

100/min

Per tenant


Supported Apps (Examples)

Productivity

  • Google Calendar
  • Asana
  • Trello
  • Monday.com
  • Notion

Communication

  • Slack
  • Discord
  • Microsoft Teams
  • Gmail
  • Outlook

Data & Analytics

  • Google Sheets
  • Airtable
  • Excel
  • BigQuery
  • Databox

CRM & Sales

  • HubSpot
  • Salesforce
  • ActiveCampaign

Social Media

  • Twitter (via social publishing)
  • LinkedIn (via social publishing)
  • Instagram (via social publishing)
  • Facebook (via social publishing)
  • TikTok (via social publishing)

Marketing

  • Mailchimp
  • ConvertKit
  • ActiveCampaign
  • Klaviyo
  • Sendinblue

E-commerce

  • Shopify
  • WooCommerce
  • Stripe
  • PayPal
  • BigCommerce

Total available: 6,000+ apps


Get Help

Common Questions

Q: Can I use Zapier with the free trial? A: Yes, all trial users have full Zapier access.

Q: Do Zapier tasks count toward my ILLIXIS quota? A: Actions (Create Brief, Generate Content) count toward your plan limits. Triggers do not.

Q: Can I connect multiple Zapier accounts? A: Yes, authorize each Zapier account separately. Each gets its own OAuth token.

Q: What happens if I downgrade my plan? A: Existing Zaps continue working, but actions may fail if you exceed new plan limits.

Q: Can I test webhooks locally? A: Use tools like ngrok or RequestBin to receive webhooks during development.

Support

Webhook issues: Check Settings → Integrations → Zapier for error logs

Zap not working: Review Zapier Zap History for detailed error messages

Need help: Contact support@illixis.io with your Zap URL and error details


What's Next