Zapier + Auggie Integration Guide
Automate AI-powered account research in your Zapier Zaps.
Overview
Auggie provides AI-powered account research that analyzes a company's website and public data to produce pain scores, business problems, talking points, and product-fit assessments. With Zapier, you can trigger Auggie research automatically from any event in your workflow — a new CRM lead, a spreadsheet row, or a scheduled timer.
Prerequisites
-
1
Auggie API key — create one at /api-keys (starts with
aug_) -
2
Zapier account — Professional plan or higher for webhooks
-
3
Auggie webhook registered — see the webhook setup section below
Single Research — Webhook Approach
Strongly Recommended-
1
Create a Zap with Webhooks by Zapier > Catch Hook as the trigger. Copy the generated webhook URL.
-
2
Register that URL with Auggie via
POST /v1/webhooks/register:curl -X POST https://auggie.app/v1/webhooks/register \ -H "Authorization: Bearer aug_your_key" \ -H "Content-Type: application/json" \ -d '{"url": "https://hooks.zapier.com/hooks/catch/YOUR_HOOK_ID"}' -
3
Create a separate Zap with your desired trigger (Schedule, new Google Sheets row, etc.) and add Webhooks by Zapier > Custom Request as the action.
-
4
Configure the Custom Request to POST to
https://auggie.app/v1/research -
5
Set headers:
Key Value Authorization Bearer aug_your_key Content-Type application/json -
6
Set the request body (Data field):
{"company_url": "https://example.com"} -
7
When research completes, Auggie sends the results to your Catch Hook Zap automatically.
-
8
Add downstream actions in the Catch Hook Zap: Google Sheets, Slack, email, CRM update, etc.
Visual Flow
Zap 1: [Schedule / Sheet Row] → [Custom Request POST /v1/research]
Zap 2: [Catch Hook] → [Process Data] → [Google Sheets / Slack]
Single Research — Polling Approach
-
1
Trigger — Schedule, new Google Sheets row, or any other trigger.
-
2
Webhooks by Zapier > Custom Request — POST to
/v1/researchwith headers and data as shown in the webhook section above. -
3
Delay by Zapier — 30 seconds (Zapier minimum).
-
4
Another Custom Request — GET the research result:
GET https://auggie.app/v1/research/{{steps.2.job_id}}Use the same Authorization and Content-Type headers.
-
5
Filter by Zapier — Only continue when
statusequalscompleted.
Visual Flow
[Trigger] → [Custom Request POST] → [Delay 30s] → [Custom Request GET] → [Filter: completed?]
Bulk Research
-
1
Use Code by Zapier (JavaScript) to collect URLs from previous steps into an array:
// Code by Zapier — JavaScript const urls = inputData.urls.split(',').map(u => u.trim()); output = [{ company_urls: JSON.stringify(urls) }]; -
2
Custom Request — POST to
/v1/research/bulk:{ "company_urls": ["https://acme.com", "https://globex.com"], "name": "Zapier bulk import" } -
3
Use a Catch Hook Zap (as described in the webhook section) to receive completed results via webhook.
Using Results
Zapier flattens nested JSON objects using double underscores. When referencing Auggie result fields in downstream steps, use this format:
| Zapier Field Reference | Description |
|---|---|
| {{steps.4.scores__pain}} | Pain score (0–100) |
| {{steps.4.scores__composite}} | Composite score |
| {{steps.4.sections__talking_points}} | AI-generated talking points |
| {{steps.4.sections__business_problems}} | Identified business problems |
| {{steps.4.sections__product_fit}} | Product-fit assessment |
Key fields: composite score, pain score, talking_points, business_problems, product_fit.
Troubleshooting
| Issue | Solution |
|---|---|
| 401 Unauthorized | Check header key/value format in Custom Request. Key must be Authorization, value must be Bearer aug_... |
| Timeout / incomplete | Research takes 30–60s. Use the webhook approach instead of polling. |
| Webhook not firing | Verify registration via the API, check Catch Hook URL is correct, and ensure the Zap is turned on. |
| 402 Payment Required | No credits remaining. Purchase more at /billing/buy-credits. |
| 429 Rate Limited | Add Delay steps between requests to stay within rate limits. |
| Zapier can't loop | Use the webhook approach — polling with Filter will stop if research is not completed in time. |