Prerequisites
Before you begin, ensure you have:- A Doozy account with API access enabled (see Authentication)
- A Doozy API key
- A Zapier account (Professional plan or higher recommended for Webhooks)
Using Webhooks by Zapier
Since there isn’t a native Doozy app in Zapier, you’ll use Webhooks by Zapier to make API requests.1
Create a New Zap
Log in to Zapier and click Create Zap.
2
Add a Trigger
Choose any trigger that suits your workflow (e.g., Schedule by Zapier for periodic reports).
3
Add Webhooks by Zapier Action
Click + to add an action, search for Webhooks by Zapier, and select Custom Request.
4
Configure the Request
Set up the webhook with the following settings:
In Zapier, headers use the format
Header-Name | Header-Value. Enter your API key as:5
Test the Action
Click Test action to verify the connection. You should see your quiz data in the response.
Example: Fetching a Quiz Report
To fetch detailed results for a specific quiz:
Replace
{quizId} with the actual quiz ID from your Doozy dashboard.
Parsing the Response
The API returns JSON data. To use specific fields in subsequent Zap steps:1
Access Response Data
After testing the webhook, Zapier automatically parses the JSON response.
2
Use Fields in Later Steps
In subsequent actions, you can reference specific fields from the response, such as:
quiz.title- The quiz titlesummary.totalParticipants- Number of participantssummary.averageScore- Average quiz score
Handling Pagination
For endpoints returning multiple items:-
Make the initial request with a
limitparameter in the URL: - Use Zapier’s Looping by Zapier or Paths to handle pagination if you need more than 100 items.
Example Workflow: Daily Quiz Summary to Slack
1
Schedule Trigger
Use Schedule by Zapier to run daily at your preferred time.
2
Fetch Quiz Report
Add Webhooks by Zapier → Custom Request to fetch
/v1/quizzes/{quizId}/report.3
Format the Message
Use Formatter by Zapier to create a summary message with the quiz results.
4
Send to Slack
Add Slack → Send Channel Message to post the summary.
Example Workflow: Export Quiz Results to Google Sheets
1
Schedule Trigger
Use Schedule by Zapier to run weekly.
2
Fetch Quiz Data
Use Webhooks by Zapier to fetch quiz report data.
3
Add to Spreadsheet
Use Google Sheets → Create Spreadsheet Row to log the results.
Error Handling
Zapier will mark a Zap step as failed if it receives a non-2xx response. Common errors:
See Error Handling for a complete list of error codes.
Security Best Practices
- Keep your Zaps private
- Regularly rotate your API keys (see Authentication)
- Monitor your Zap history for unexpected errors