Zapier Integration

Overview

Warpflow Signals provides three AI-powered actions and a full pipeline endpoint that work with Zapier, Make, n8n, or any platform that can make HTTP requests with Bearer auth.

Actions call individual pipeline steps — classify a conversation, score a contact, or generate a reply. Use these when you want fine-grained control.

Full Pipeline runs everything in one call — classify → score → route → reply. Use this when you want Warpflow to handle the entire flow.

Available actions

Classify Conversation

Analyzes a message and returns structured classification.

POST /api/v1/actions/zapier/{tenant_id}/classify-conversation
Authorization: Bearer <api_key>
Content-Type: application/json

Request:

{
  "message": "I need to schedule a root canal. My insurance is Delta Dental PPO and I'm in a lot of pain.",
  "contact": {
    "name": "Jane Doe",
    "email": "jane@example.com"
  }
}

Response:

{
  "intent": "appointment_request",
  "urgency": "high",
  "sentiment": "negative",
  "summary": "Urgent dental appointment request for root canal, has Delta Dental PPO insurance",
  "confidence": 0.94
}

Score Contact

Evaluates a contact's value based on their message and any conversation history.

POST /api/v1/actions/zapier/{tenant_id}/score-contact
Authorization: Bearer <api_key>
Content-Type: application/json

Request:

{
  "message": "We're looking to remodel our kitchen. Budget is around $40k and we'd like to start next month.",
  "contact": {
    "name": "John Smith",
    "phone": "+15551234567"
  }
}

Response:

{
  "score": 82,
  "tier": "hot",
  "buying_signals": ["stated_budget", "specific_timeline", "specific_project"],
  "recommended_actions": ["immediate_follow_up", "schedule_consultation"]
}

Generate Reply

Creates a brand-voice reply with Signal Guard evaluation.

POST /api/v1/actions/zapier/{tenant_id}/generate-reply
Authorization: Bearer <api_key>
Content-Type: application/json

Request:

{
  "message": "Do you offer free consultations for estate planning?",
  "contact": {
    "name": "Sarah Johnson"
  }
}

Response:

{
  "reply": "Hi Sarah! Yes, we offer complimentary 30-minute estate planning consultations. Would you like to schedule one? I have availability this week on Tuesday and Thursday afternoons.",
  "guardrail_passed": true,
  "guardrail_notes": null
}

The reply uses your tenant's brand voice settings (tone, persona, vocabulary, prohibited phrases). If Signal Guard triggers, guardrail_passed is false and guardrail_notes explains why.

Full Pipeline

Runs the complete pipeline in one synchronous call.

POST /api/v1/webhook/zapier/{tenant_id}
Authorization: Bearer <api_key>
Content-Type: application/json

Request:

{
  "contact": {
    "name": "Jane Doe",
    "email": "jane@example.com",
    "phone": "+15551234567"
  },
  "content": {
    "body": "I need a quote for a kitchen remodel. Budget is $40k."
  }
}

Response:

Returns classification, score, matched rules, and generated reply — same format as sync mode webhooks.

Setting up in Zapier

Step 1: Create an API key

1. Open the Signals dashboard → Settings → API Keys
2. Click Create API Key and label it "Zapier"
3. Copy the key

Step 2: Create a Zap

Use the Webhooks by Zapier app (or your trigger of choice) and a Code by Zapier or Webhooks by Zapier (POST) action step.

Example: Typeform submission → Classify + Score → Slack alert

1. Trigger: Typeform → New Entry
2. Action: Webhooks by Zapier → POST
   • URL: https://api.warpflow.ai/api/v1/webhook/custom/{tenant_id}/typeform?mode=sync
   • Headers: Authorization: Bearer wf_your_key
   • Body: Map Typeform fields to the webhook payload
3. Action: Filter → Only continue if score.tier is hot
4. Action: Slack → Send Channel Message with the classification summary

Step 3: Use individual actions

For more control, call the action endpoints directly:

1. Action: Webhooks by Zapier → POST to /api/v1/actions/zapier/{tenant_id}/classify-conversation
2. Use the classification result to decide next steps in your Zap
3. Optionally call score or generate-reply in subsequent steps

Using with Make (Integromat)

Make supports HTTP modules natively. Use the HTTP → Make a request module:

• URL: Any Warpflow API endpoint
• Method: POST
• Headers: Authorization: Bearer <api_key>, Content-Type: application/json
• Body: JSON payload

The same applies to n8n (HTTP Request node), Pipedream (HTTP action), or any automation platform with HTTP support.

Authentication

All endpoints use the same Bearer token auth. Create an API key in the dashboard and include it in every request:

Authorization: Bearer wf_your_tenant_abc123

See Authentication for details on key management, rotation, and limits.

Credit usage

Each AI action (classify, score, generate reply) consumes one AI signal from your plan. The full pipeline endpoint consumes one signal that covers all steps. Check your usage in Settings → Plan & Usage or via the API:

GET /api/v1/tenants/{tenant_id}/usage

Next steps

• Authentication — set up API keys
• Webhooks — send events from any source
• Integration Recipes — common automation patterns