CodeSignal

this article walks you through integrating your codesignal account with ashby, so you can use codesignal tests and certifications as assessments in your interview plans you can also configure the integration to attach codesignal interviews to your ashby interview calendar invites prerequisites before you begin, make sure you can log in to codesignal and see the webhooks and api keys sections in the codesignal integrations settings panel https //app codesignal com/client dashboard/integrations/ats greenhouse on the left side of the page if you don't see those options, email support\@codesignal com mailto\ support\@codesignal com to request access setting up the integration setup moves back and forth between ashby and codesignal, so open both in browser tabs before you start open a browser tab with the ashby integrations marketplace at admin > integrations > integrations open another browser tab with the codesignal api keys https //app codesignal com/client dashboard/integrations/api keys page adding the integration in ashby from ashby's integrations https //app ashbyhq com/admin/integrations/marketplace page, click the codesignal integration tile, then click enable codesignal once that's done, you see a panel to configure keys for the integration you return here to input your codesignal api key once you have it click the ashby api key drop down to create or select an existing api key for this integration if you're using an existing api key, ensure it has write access to the candidates set of endpoints this set contains the assessment update endpoint, which codesignal uses to send assessment data back to ashby if you created a new api key, copy it and keep it in a safe place you need it for the configuration on the codesignal side getting the codesignal api key next, you need an api key from codesignal so that ashby can interact with codesignal navigate to the codesignal api keys https //app codesignal com/client dashboard/integrations/api keys page click add a key , and describe your key with a title like ashby integration in the pop up that follows click the arrow in the bottom right, then enable the following permissions companytest company read companytestsession company write liveinterview\ company read (to use the live interviews option) liveinterview\ company write (to use the live interviews option) click save at the bottom your new api key appears in the list click your new key in the key column to copy it somewhere temporarily, as you need it in a moment return to the ashby integrations admin https //app ashbyhq com/admin/integrations/marketplace page and enter your new codesignal api key in the topmost box in the ashby codesignal settings — the same place where you started with the ashby api key setup to edit an existing key in codesignal to enable additional permissions, click the pencil icon next to the api key in question connecting the codesignal webhook to ashby next, set up the webhook so codesignal can notify ashby about updates to assessments navigate to the codesignal webhooks https //app codesignal com/client dashboard/integrations/webhooks page click add a webhook in the top right in the screen that appears, configure the following settings name value(s) add event types companytestsessionstarted companytestsessionfinished prescreenresultshared prescreenresultverified prescreenexpired prescreencandidatedeclined prescreenresultnotverified prescreenresultverificationpending endpoint https //app ashbyhq com/api/codesignal webhook https //app ashbyhq com/api/codesignal webhook secret key paste the api key you just created from codesignal (don't click the refresh button) email assessment webhooks\@ashbyhq com mailto\ assessment webhooks\@ashbyhq com (automatically notifies us if this webhook fails) custom headers add one and set the key as x ashby api key and the value as the api key you generated in ashby click the test button if all is well, you see a success message if you run into issues, double check your configuration and ensure you completed the final step from the codesignal api key setup, where you save the codesignal api key into ashby click create your integration is now configured you can start adding take home tests and interviews via codesignal to your interview plans adding take home tests now that the integration is configured, you can start sending codesignal take home assessments to candidates to add an interview assessment at the interview plan level, go to the interview plan you want to update and click + activity on the stage you want to add a codesignal take home assessment to click codesignal from the list of activities that opens on the right side of the page, then select the assessment you'd like candidates to complete at this interview stage when a candidate reaches the stage the take home is assigned to, an activity shows up on their profile indicating that you should send them an assessment to send an assessment to a candidate, click start assessment on the activity on the candidate's profile if you enable automate on stage entry for the activity, ashby triggers and sends the assessment automatically ashby emails the candidate a link to the selected take home assessment once they complete the assessment, ashby updates its status assessment statuses can take up to four hours to reflect in ashby adding a codesignal interview to ashby interviews alternatively, ashby can automatically attach live interview links to interview invitations when you schedule an interview or create a schedule interview activity when scheduling an interview or configuring a schedule interview activity, check the attach codesignal interview? checkbox this option is under communications for a schedule interview activity, or under invite settings when scheduling an interview manually if you have an interview with multiple events, you can use checkboxes to specify the events that should have the integration enabled ashby includes the interview link in both interviewer and candidate invitations after you schedule the interview and ashby sends the calendar invites, you can also access the live interview link via the record of the interview in the interview progress section of the candidate's job consideration faqs does a user need specific permissions in codesignal to create an assessment or interview in ashby? because the assessment generates via the api key, codesignal doesn't require specific user roles