This article outlines how to leverage CodeSignal’s webhooks functionality to feed CodeSignal assessment results into a Zapier app of your choice using Webhooks by Zapier.
The article describes setting up a zap to send either Certify or Test assessment results.
Prerequisites
- You must have a paid Zapier account that provides access to Premium apps.
- You must have Admin permissions in your company’s CodeSignal account.
- You must have access to CodeSignal APIs & Webhooks through your plan.
Steps
1. Go to Zapier and create a new zap. When prompted to Choose App & Event, choose the Webhooks by Zapier app.
2. In the drop-down menu for Choose Trigger Event, select Catch Hook. Then, click the CONTINUE button.
To add another layer of security to your integration using the CodeSignal Secret Key, select Catch Raw Hook instead. This requires more advanced knowledge of Zapier.
3. Once the Trigger Event is selected, you will be prompted to Customize Request. Click Copy to copy the Custom Webhook URL to your clipboard.
4. In a separate tab, log into your CodeSignal account and click on your account menu. Select INTEGRATIONS.
5. Click Webhooks in the left navigation bar. Then, click the ADD A WEBHOOK button, which will bring up a pop-up window.
6. In the Add event types field, choose the appropriate event type for the type of assessment you are using:
- For Certify, use certificationResultShared
- For Test, use companyTestSessionFinished
(See CodeSignal’s API for Developers: Webhooks documentation for a list and description of all event types.)
7. Paste the Webhook URL from your clipboard into the Endpoint field. To confirm the webhook works, click TEST. You should see a pop-up box in the top right corner that says Endpoint Test Passed.
Then, enter an email address where you would like to receive notifications about the integration. Click CREATE at the bottom of the pop-up window.
8. Return to Zapier and click Test Trigger. To test the trigger, you'll need to take and submit an assessment as a candidate from your company's CodeSignal account. Then, test the most recent request, which you can select from the drop-down menu.
9. Click CONTINUE. Now, you can add any other steps in your zap to utilize this powerful CodeSignal Webhook.
Here are some of the popular applications that can be used with Zapier:
Questions? Reach out to us at support@codesignal.com