Test and monitor your integration in your Zapier account
Testing inside the Platform UI is crucial during the building process. To ensure users can benefit from your integration’s features, it is equally crucial to test your integration within the Zap editor. This is the best way to notice details that might have been overlooked while building your integration.
Prerequisites
- Completed build of your Zapier integration
- A Zapier account
- If you haven’t used Zapier before, you’ll want to learn the basics in our Zapier Getting Started Guide.
- Set of valid user credentials for your app - recommended to use a new account specifically for testing so you don’t clutter your core app account with testing data.
Steps
-
Create a Zap in the Zap editor, selecting your app in the Choose App selector.
-
Your integration will show the name and logo set in Integration Settings, along with the integration’s current version number and a By Invite tag. If your integration is a new version of an existing Public integration, look for the Latest tag, the latest version number and the By Invite tag to differentiate from existing, public integrations.
-
Check each of the following as you setup Zaps:
- Authentication: Does your app account successfully connect? Zapier will show any testing accounts you already added, but try adding a new account here for a complete test. To remove connected accounts, you can delete connections from Apps/Custom integrations.
- Connection Label: Does the Zap editor show the expected connection label on the new account, with the info you set when building your integration?
- Trigger and Action List: Do you see every trigger and action included in your integration? Is each trigger and action’s name and description accurate and grammatically correct?
- Fields: Do triggers and actions show the input fields you expect? Are their names and labels accurate and grammatically correct? Do any links or formatting in descriptions work correctly? Do drop-down fields or those with multiple selectors work correctly?
- Output: When you run a Zap trigger or action’s test, does the step return the fields and data you expect in the correct format? Do triggers show the most recently added item from your app, and do searches return appropriate results?
- Input: Open your app, and check each item that Zapier actions added or updated for the correct format and expected appearance in your app.
- Automation: Turn on Zaps with each of your integration’s triggers and actions. Do they run correctly when the data they watch for is added or updated in your app? You can check your Zap History to make sure Zaps ran as expected for triggering events. Do your integration’s actions successfully add and update items when those Zaps are triggered?
Monitoring
Use the Monitoring page in the Platform UI to ensure that test Zaps and the expected requests are running without errors. Every request made to your API by your Zapier integration is shown.
Adjust the Chart Filter for the correct timeframe, then click on any data point in the chart to see the any error messages and logs which should help you troubleshoot further. You can also filter by log type and by user email.
To manually print a log statement you can see in Monitoring, use z.console.log
in Code Mode:
z.console.log('Here are the input fields', bundle.inputData);
User testing
Have internal team members and/or beta users test your integration. If you are going to submit your app for Publishing in the Zapier App Directory, you’ll need at least 3 users with live Zaps. Each additional tester helps ensure that your app doesn’t ship with usability problems or bugs.
Internal team members can be invited from Manage Team as admins or collaborators.
Beta users external to your organization can be invited from Sharing
The Insights section in the Platform UI provides usage statistics by trigger and action.
Need help? Tell us about your problem and we’ll connect you with the right resource or contact support.