Dvorac
Back

Developer reference

Zapier Webhook API

Everything Zapier and your developers need to connect a workspace: one authenticated endpoint, three actions, and predictable JSON responses.

Overview

This API provides integration with Zapier for managing webhooks and retrieving recent leads. It supports actions such as subscribing to a webhook, unsubscribing from a webhook, and fetching recent leads. Every request is authenticated with the private workspace key found in your Dvorac dashboard.

Endpoint

GET https://us-central1-dvoracapp.cloudfunctions.net/zapierWebhook
(Hosted on Google Cloud / Firebase Functions)

Request parameters

ParameterTypeDescriptionRequired
zapierKeystringThe unique key used to identify the user in the database.Yes
actionstringThe action to be performed. Valid values: getRecentLeads, subscribeHook, unsubscribeHook.Yes
hookUrlstringThe URL for the webhook to be subscribed or unsubscribed (only required for subscribeHook and unsubscribeHook actions).No

Response format

The API returns a JSON object containing the result of the request. The format of the response depends on the action performed.

Default response

{
  "message": "Zapier Request Received",
  "user": "user_uid",
  "displayName": "User",
  "email": "user@example.com"
}

getRecentLeads response

[
  {
    "name": "Lead Name",
    "email": "lead@example.com",
    "phone": "123-456-7890",
    "status": "Status",
    "type": "Type"
  },
  ...
]

subscribeHook response

{
  "message": "Hook Url Saved",
  "hookUrl": "https://hookurl.com"
}

unsubscribeHook response

{
  "message": "Hook Url Deleted",
  "hookUrl": "https://hookurl.com"
}

Error handling

If an error occurs, the API returns a JSON object with a descriptive message.

{
  "message": "Zapier Key Not Found"
}

Endpoint ownership

This endpoint is owned and operated by Dvorac. It is hosted on Google Cloud (Firebase Functions) and is used solely to connect a customer's Dvorac workspace to that customer's own Zapier account, authenticated by the customer's private workspace key. Questions from the Zapier review team can be sent to support@dvorac.com.