Introduction & Setup
Learn how to install and configure the AgentBrains Zapier integration
Zapier Actions Setup
Build workflow logic in Zapier and use AgentBrains for knowledge access, semantic retrieval, image lookup, employee configuration, and company context.
The AgentBrains Zapier integration connects Zapier workflows to the parts of AgentBrains that matter in production:
Semantic Retrieval
Retrieve text and image assets using semantic RAG.
Knowledge Base
Access entities, categories, and relationship types deterministically.
AI Employee Config
Load employee configurations, settings, or instructions.
Company Context
Get tenant-level company details for email/CRM context.
Why use the Zapier integration
Using dedicated AgentBrains Zapier actions removes repetitive API webhook setup and makes workflows easier to maintain.
| Benefit | What you get in Zapier |
|---|---|
| Credential handling | Your AgentBrains API key is stored once in the Zapier connected account instead of being repeated in every webhook step. |
| Better AI ergonomics | RAG, image, entity, category, and employee responses are shaped for Zapier field mapping and downstream AI tools. |
| Visual selection | RAG indexes, categories, category types, and employees can be selected from dropdowns instead of hardcoded IDs. |
| Faster production setup | You can search your knowledge base, retrieve images, load company data, and fetch employee configuration without building custom request chains first. |
Install the Zapier integration
AgentBrains is available as a private Zapier integration invite.
Accept the private invite
Open the invite link and accept to add AgentBrains to your Zapier account:
Create a Zap
Create a new Zap in your Zapier dashboard.
Select AgentBrains Action
Search for AgentBrains in the Zap action app selector and select the action you want to use.
Connect credentials
Create a connection using your AgentBrains API key.
Important Notes
- The invite link may require you to be logged in to Zapier first.
- If the integration is not visible immediately, refresh the Zap editor after accepting the invite.
- If your Zapier workspace has app restrictions, an admin may need to approve the integration.
Configure credentials
Create one AgentBrains connection in Zapier and reuse it across all actions.
| Field | Description |
|---|---|
| AgentBrains API Key | Your AgentBrains API key |
The connection verifies the key against AgentBrains and then sends the token automatically with each request. You do not need to manually configure request headers.
API Key Required
The integration sends the key using secure API headers, including bearer-token and access-key authentication. If you need help creating a token, see Access API Key.
Troubleshooting
The integration does not appear in Zapier
Open the invite link while logged in to Zapier, accept the invite, then refresh the Zap editor:
Authentication fails
Confirm that you are using a valid AgentBrains API key.
A field filter returns only IDs
Make sure the Fields input uses real AgentBrains API field names (e.g. details instead of Document Details). See Knowledge Base & Settings for more details.
A parent category filter fails
Only use Parent Category ID when you have a valid parent category ObjectId. Leave it empty otherwise.
A list action returns too much data
Use filters such as category, search, source, SKU, tags, recursive, or fields.
You need image data
Use Retrieve Images from RAG, then Get an image. Avoid listing all attachments unless you specifically need that behavior, because attachment collections can be large.
Next steps
- Accept the AgentBrains Zapier integration invite.
- Connect your AgentBrains API key.
- Test RAG & Search.
- Test Knowledge Base & Settings.