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.

Note: Zapier cannot loop or poll natively. The webhook approach is strongly recommended for reliable results.

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
Webhook approach is strongly recommended for Zapier since Zapier cannot loop natively. The polling approach below has limitations.
  1. 1
    Create a Zap with Webhooks by Zapier > Catch Hook as the trigger. Copy the generated webhook URL.
  2. 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. 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. 4
    Configure the Custom Request to POST to https://auggie.app/v1/research
  5. 5
    Set headers:
    KeyValue
    AuthorizationBearer aug_your_key
    Content-Typeapplication/json
  6. 6
    Set the request body (Data field):
    {"company_url": "https://example.com"}
  7. 7
    When research completes, Auggie sends the results to your Catch Hook Zap automatically.
  8. 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

Warning: Zapier cannot loop. If research isn't complete after 30 seconds, the Zap will stop. For reliable results, use the webhook approach above.
  1. 1
    Trigger — Schedule, new Google Sheets row, or any other trigger.
  2. 2
    Webhooks by Zapier > Custom Request — POST to /v1/research with headers and data as shown in the webhook section above.
  3. 3
    Delay by Zapier — 30 seconds (Zapier minimum).
  4. 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. 5
    Filter by Zapier — Only continue when status equals completed.

Visual Flow

[Trigger] → [Custom Request POST] → [Delay 30s] → [Custom Request GET] → [Filter: completed?]

Bulk Research

  1. 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. 2
    Custom Request — POST to /v1/research/bulk:
    {
      "company_urls": ["https://acme.com", "https://globex.com"],
      "name": "Zapier bulk import"
    }
  3. 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.