Integration Recipes

Qualify a form submission

Send form content to the full Zapier pipeline using your tenant API key:

curl -X POST https://api.warpflow.ai/api/v1/webhook/zapier/YOUR_TENANT_ID \
  -H "Authorization: Bearer YOUR_TENANT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"I need a kitchen remodel quote. Budget is $40k.","contact":{"name":"Jane Doe","email":"jane@example.com"},"channel":"webhook"}'

If score is present and score.tier is hot, notify your team. Check pipeline results that may be null and reply.requires_approval before using generated content. Response fields are documented in Zapier integration.

Score a message without AI

The standalone score-contact endpoint currently uses heuristic scoring. Supply top-level message and optional nested contact, and read data.lead_score and data.lead_tier from the {success,data,error} response. Standalone classification and reply generation currently lack an LLM provider; use the full pipeline for those steps.

Send connected email

curl -X POST https://api.warpflow.ai/api/v1/tenants/YOUR_TENANT_ID/email/send \
  -H "Authorization: Bearer YOUR_TENANT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":[{"email":"jane@example.com"}],"subject":"Following up","body":"Our team will contact you shortly."}'

Use a tenant API key, an authorized Cognito ID token, or an embedded session token for this tenant. A successful send returns 201 with success, message_id, and thread_id. Email requires a connected account and is unavailable for HIPAA-enabled tenants. See Email API.

Custom event sources

The custom webhook requires a separately provisioned source webhook key and an entity/content payload. Its synchronous mode evaluates rules only; use the Zapier pipeline recipe above when you need AI classification, scoring, and replies.