Integrationv1.0

Zapier Integration

Connect Typani to 7,000+ apps with Zapier. Get notified in Slack, log reviews to a spreadsheet, create support tickets, or build any workflow you need — triggered every time a new review arrives.

Overview

The Typani Zapier integration provides a polling trigger that fires when new reviews are detected for any of your connected business locations. Each trigger event includes the full review text, star rating, sentiment analysis, and an AI-drafted reply.

Available trigger: New Review Received — fires for each new review across all your connected locations.

Authentication

Typani uses API Key authentication. Every request must include your API key in the X-API-Key header.

Generating your API key

Log in to your Typani dashboard
Go to Settings → Integrations
Click Generate API Key
Copy the key — it is only shown once

Example request

curl -H "X-API-Key: typ_your_api_key_here" \
  https://typani.com/api/zapier/me

Response

{
  "business_name": "Downtown Coffee Shop",
  "email": "owner@example.com"
}

Trigger: New Review Received

Zapier polls the GET /api/zapier/reviews endpoint to detect new reviews. Each review is identified by a unique id — Zapier uses this to deduplicate and only trigger on reviews it hasn't seen before.

Endpoint

GET https://typani.com/api/zapier/reviews
Header: X-API-Key: typ_your_api_key_here

Returns the 25 most recent reviews across all connected locations, sorted newest first.

Example response

200 OK

[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "location_name": "Downtown Coffee Shop",
    "reviewer_name": "Jane Smith",
    "rating": 5,
    "review_text": "Best coffee in town! The staff is incredibly friendly.",
    "sentiment": "positive",
    "ai_draft_reply": "Thank you so much, Jane! We're thrilled you love our coffee.",
    "review_timestamp": "2026-07-15T14:30:00.000Z",
    "dashboard_link": "https://typani.com/app/reviews"
  }
]

Response Fields

Field	Type	Description
id	string	Unique review identifier (UUID)
location_name	string	Business location name
reviewer_name	string	Name of the person who left the review
rating	number	Star rating (1-5)
review_text	string	Full text of the review
sentiment	string	One of: "positive", "mixed", or "negative"
ai_draft_reply	string \| null	AI-generated reply draft, or null if not yet generated
review_timestamp	string	ISO 8601 timestamp of when the review was posted
dashboard_link	string	Direct link to manage this review in Typani

Error Handling

Status	Meaning
200	Success — returns an array of reviews
401	Invalid or missing API key
500	Server error — retry after a few seconds

Rate Limits

The Zapier integration endpoints are designed for polling and are rate-limited to 100 requests per minute per API key. Zapier's default polling interval (every 1-15 minutes depending on your Zapier plan) stays well within this limit.

Support

Need help setting up your Zapier integration? Reach out to us:

Email: support@typani.com
Dashboard: typani.com/app/settings