Zapier Integration

Connect FLTR to thousands of apps using Zapier’s Webhooks action. Build powerful automation workflows that combine semantic search with your favorite tools.

What You Can Build

Email Search

Search email attachments when new messages arrive in Gmail

Document Q&A

Answer Slack questions using your knowledge base

Support Automation

Auto-respond to support tickets with relevant docs

Content Discovery

Find related content when creating new documents

Prerequisites

FLTR Account

API Key

Generate an API key in Settings → API Keys

Zapier Account

Create a free account at zapier.com

Dataset ID

Create a dataset and note its ID (e.g., ds_abc123)

Quick Start: Search on New Email

Let’s build a Zap that searches your knowledge base when you receive an email.

Step 1: Create a New Zap

Log in to Zapier
Click Create Zap
Name it “Email to FLTR Search”

Step 2: Configure Trigger

Search for Gmail as the trigger app
Choose event: New Email
Connect your Gmail account
Configure filters (optional):
- Label: “Support”
- Has attachment: Yes
Test the trigger

Step 3: Add FLTR Search Action

Click + to add an action
Search for Webhooks by Zapier
Choose action event: POST

Configure the webhook: URL:

https://api.fltr.com/v1/mcp/query

Payload Type: JSON Data:

{
  "query": "{{gmail_subject}} {{gmail_body_plain}}",
  "dataset_id": "ds_abc123",
  "limit": 3
}

Headers:

Authorization: Bearer YOUR_FLTR_API_KEY
Content-Type: application/json

Replace YOUR_FLTR_API_KEY with your actual API key from the FLTR dashboard.

Step 4: Process Results

Add another action to use the search results: Example: Send to Slack

Add action: Slack → Send Channel Message
Configure message:

📧 New support email from {{gmail_from_email}}

Subject: {{gmail_subject}}

🔍 Related docs:
{{webhooks_response_results_0_content}}
Source: {{webhooks_response_results_0_metadata_title}}

{{webhooks_response_results_1_content}}
Source: {{webhooks_response_results_1_metadata_title}}

Step 5: Test and Enable

Click Test action to verify it works
Check the results in Slack
Click Publish to enable your Zap

Common Zap Templates

1. Slack Q&A Bot

Trigger: Slack → New Message in Channel Action: FLTR → Query Dataset Action: Slack → Reply in Thread

{
  "query": "{{slack_message_text}}",
  "dataset_id": "ds_your_kb_id",
  "limit": 1,
  "rerank": true
}

2. Google Drive Document Indexer

Trigger: Google Drive → New File in Folder Action: Google Drive → Download File Action: FLTR → Upload Document

{
  "file_url": "{{gdrive_file_download_url}}",
  "metadata": {
    "title": "{{gdrive_file_name}}",
    "source": "Google Drive",
    "created_at": "{{gdrive_file_created_time}}"
  }
}

3. Customer Support Automation

Trigger: Zendesk → New Ticket Action: FLTR → Query Dataset Action: Zendesk → Add Private Comment

{
  "query": "{{zendesk_ticket_subject}} {{zendesk_ticket_description}}",
  "dataset_id": "ds_support_docs",
  "limit": 5
}

4. Content Recommendation Engine

Trigger: WordPress → New Post Action: FLTR → Query Dataset Action: WordPress → Update Post (add related links)

{
  "query": "{{wordpress_post_title}} {{wordpress_post_excerpt}}",
  "dataset_id": "ds_blog_posts",
  "limit": 3
}

All FLTR Endpoints for Zapier

Query Dataset

Search your dataset with semantic search. URL: https://api.fltr.com/v1/mcp/query Method: POST Request Body:

{
  "query": "search term",
  "dataset_id": "ds_abc123",
  "limit": 5,
  "rerank": false
}

Response:

{
  "results": [
    {
      "chunk_id": "ch_xyz789",
      "content": "Result text...",
      "score": 0.89,
      "metadata": {
        "title": "Document Title"
      }
    }
  ]
}

Accessing Results in Zapier:

First result content: {{webhooks_response_results_0_content}}
First result score: {{webhooks_response_results_0_score}}
Second result title: {{webhooks_response_results_1_metadata_title}}

Create Dataset

URL: https://api.fltr.com/v1/datasets Method: POST

{
  "name": "{{trigger_value}}",
  "description": "Created from Zapier",
  "is_public": false
}

Upload Document

URL: https://api.fltr.com/v1/datasets/DATASET_ID/documents Method: POST For text content:

{
  "content": "{{document_text}}",
  "metadata": {
    "title": "{{document_title}}",
    "source": "Zapier",
    "created_at": "{{trigger_time}}"
  }
}

For file uploads: Use Webhooks by Zapier with Custom Request and add file as form data.

List Datasets

URL: https://api.fltr.com/v1/datasets Method: GET No request body needed. Returns all your datasets.

Batch Query

Search multiple queries at once. URL: https://api.fltr.com/v1/mcp/batch-query Method: POST

{
  "queries": [
    "First question",
    "Second question"
  ],
  "dataset_id": "ds_abc123",
  "limit": 3
}

Advanced Techniques

Filter Results by Metadata

Add filters to your query:

{
  "query": "authentication",
  "dataset_id": "ds_abc123",
  "filters": {
    "category": "security",
    "published": true
  }
}

Enable Reranking

For better result quality, enable Cohere reranking:

{
  "query": "search term",
  "dataset_id": "ds_abc123",
  "limit": 10,
  "rerank": true
}

Reranking costs an additional $0.002 per request but significantly improves result relevance.

Multi-step Workflows

Build complex workflows:

Trigger: New form submission (Typeform)
Action: FLTR → Query similar submissions
Filter: Only continue if similarity > 0.8
Action: Send notification about duplicate
Otherwise: Create new ticket in Asana

Error Handling

Add error paths to handle API failures:

After FLTR webhook action, click +
Add Filter step
Condition: Status Code is not 200
Send error notification to Slack/email

Authentication in Zapier

Using API Keys

Most common method - add API key to headers:

Authorization: Bearer fltr_sk_abc123...

Storing API Keys Securely

Never hard-code API keys in Zap configurations:

Use Zapier’s Storage to store API key once
Reference it in webhooks: {{storage_fltr_api_key}}

Setup:

Create a Zap with Storage by Zapier
Action: Set Value
Key: fltr_api_key
Value: Your actual API key
Run once, then delete the Zap

Now reference {{storage_fltr_api_key}} in other Zaps.

Rate Limits

Zapier API requests use your FLTR rate limit:

API Key auth: 1,000 requests/hour
OAuth auth: 15,000 requests/hour

Tips for staying under limits:

Filter triggers to reduce unnecessary API calls
Use delay between actions in bulk operations
Batch queries when searching multiple terms
Cache results using Zapier Storage

Zapier Premium includes automatic retry on rate limit errors.

Troubleshooting

401 Unauthorized Error

Cause: Invalid or missing API key Solution:

# Correct header format
Authorization: Bearer fltr_sk_abc123...

# Not this
Authorization: fltr_sk_abc123...

Empty Results

Cause: Dataset not indexed yet or no matching documents Solution:

Wait 30 seconds after uploading documents
Try broader search terms
Check dataset ID is correct

429 Rate Limit Exceeded

Cause: Too many requests Solution:

Add Delay between actions (1-2 seconds)
Reduce Zap frequency
Upgrade to OAuth authentication

Response Data Not Accessible

Cause: Zapier can’t parse the response Solution:

Test the webhook in Zapier
Look at the Raw Output tab
Use exact field paths like results__0__content (double underscore)

Example: Complete Email Support Bot

Here’s a full Zap configuration for an email support bot: Trigger: Gmail - New Email

Label: Support
From: Contains “@customer.com”

Action 1: Webhooks - POST

URL: https://api.fltr.com/v1/mcp/query
Method: POST

Headers:
Authorization: Bearer {{storage_fltr_api_key}}
Content-Type: application/json

Body:
{
  "query": "{{gmail_subject}} {{gmail_body_plain}}",
  "dataset_id": "ds_support_kb",
  "limit": 3,
  "rerank": true,
  "filters": {
    "category": "troubleshooting"
  }
}

Action 2: Filter - Only continue if…

{{webhooks_response_results_0_score}} > 0.7

Action 3: Gmail - Send Email

To: {{gmail_from_email}}
Subject: Re: {{gmail_subject}}

Hi,

I found these resources that might help:

1. {{webhooks_response_results_0_metadata_title}}
   {{webhooks_response_results_0_content}}

2. {{webhooks_response_results_1_metadata_title}}
   {{webhooks_response_results_1_content}}

If these don't resolve your issue, our team will follow up shortly.

Best regards,
Support Bot

Action 4: Slack - Send Message

📧 Auto-responded to {{gmail_from_email}}

Relevance score: {{webhooks_response_results_0_score}}

View email: {{gmail_link}}

Resources

Zapier Webhooks Docs

Learn about Webhooks by Zapier

FLTR API Reference

Complete API documentation

Make Integration

Alternative: Use Make.com

API Keys Guide

Generate and manage API keys

Next Steps

Try the Make integration for visual workflows
Explore n8n integration for self-hosted automation
Set up webhooks for real-time notifications

Getting Started

Authentication

Integrations

Support

​Zapier Integration

​What You Can Build

Email Search

Document Q&A

Support Automation

Content Discovery

​Prerequisites

​Quick Start: Search on New Email

​Step 1: Create a New Zap

​Step 2: Configure Trigger

​Step 3: Add FLTR Search Action

​Step 4: Process Results

​Step 5: Test and Enable

​Common Zap Templates

​1. Slack Q&A Bot

​2. Google Drive Document Indexer

​3. Customer Support Automation

​4. Content Recommendation Engine

​All FLTR Endpoints for Zapier

​Query Dataset

​Create Dataset

​Upload Document

​List Datasets

​Batch Query

​Advanced Techniques

​Filter Results by Metadata

​Enable Reranking

​Multi-step Workflows

​Error Handling

​Authentication in Zapier

​Using API Keys

​Storing API Keys Securely

​Rate Limits

​Troubleshooting

​401 Unauthorized Error

​Empty Results

​429 Rate Limit Exceeded

​Response Data Not Accessible

​Example: Complete Email Support Bot

​Resources

Zapier Webhooks Docs

FLTR API Reference

Make Integration

API Keys Guide

​Next Steps

Zapier Integration

What You Can Build

Prerequisites

Quick Start: Search on New Email

Step 1: Create a New Zap

Step 2: Configure Trigger

Step 3: Add FLTR Search Action

Step 4: Process Results

Step 5: Test and Enable

Common Zap Templates

1. Slack Q&A Bot

2. Google Drive Document Indexer

3. Customer Support Automation

4. Content Recommendation Engine

All FLTR Endpoints for Zapier

Query Dataset

Create Dataset

Upload Document

List Datasets

Batch Query

Advanced Techniques

Filter Results by Metadata

Enable Reranking

Multi-step Workflows

Error Handling

Authentication in Zapier

Using API Keys

Storing API Keys Securely

Rate Limits

Troubleshooting

401 Unauthorized Error

Empty Results

429 Rate Limit Exceeded

Response Data Not Accessible

Example: Complete Email Support Bot

Resources

Next Steps