Integrations
Assessments
CodeSignal
12 min
this guide will walk you through integrating your codesignal account with ashby, allowing you to use codesignal tests and certifications as assessments in your interview plans you can also configure the integration to attach codesignal interviews to your ashby interviews calendar invites getting started checklist make sure you can login to codesignal and see the webhooks and api keys sections in your integrations settings panel on the left side https //app codesignal com/client dashboard/integrations/ats greenhouse if you don’t see those options, you’ll need to email support\@codesignal com to request access open a browser tab with ashby on the https //app ashbyhq com/admin/integrations/marketplace page open another browser tab with codesignal on the https //app codesignal com/client dashboard/integrations/api keys page add the integration in ashby starting from the https //app ashbyhq com/admin/integrations/marketplace page, click on the codesignal integration tile, and then click the green enable codesignal button once that’s done, you should see a panel to configure keys for the integration note you’ll come back 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, please ensure your ashby api key has write access to the candidates set of endpoints, as this contains the assessment update endpoint, which will be used to send data back to ashby about the assessment note copy the resulting api key, if you created a new one, and keep it in a safe place you’ll need this for the configuration on the codesignal side get the codesignal api key next, we need to get an api key from codesignal, so that ashby can interact with codesignal set up your codesignal api key by going https //app codesignal com/client dashboard/integrations/api keys click add a key , and describe your key with a title like ashby integration in the following pop up click the arrow in the bottom right, where you should 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, and then your new api key should appear in the list click on your new key in the key column to copy it somewhere temporarily, as we’ll need it in a moment go back to ashby https //app ashbyhq com/admin/integrations/marketplace , and enter your new codesignal api key in the topmost box in the ashby codesignal settings (same place where you started with the ashby api key setup initially) if you need to edit an existing key in codesignal to enable additional permissions, you should be able to click the pencil icon next to the api key in question connect the codesignal webhook to ashby next we’re going to setup the webhook, so codesignal can notify ashby about updates to assessments set up a new webhook by going https //app codesignal com/client dashboard/integrations/webhooks 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 secret key paste the api key you just created from codesignal (don't click the refresh button) email 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 your api key that you generated in ashby if all is well, you should be able to click the test button and see a success message if you run into issues, double check your configuration, and ensure you did the final step from the codesignal api key setup, where you save the codesignal api key into ashby once you’re done, click the create button you can now 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 on + activity to on the stage you want to add a codesignal take home assessment to click on codesignal from the list of activities that opens on the right side of the page and select the assessment you’d like candidates to complete at this interview stage cleanshot 2022 12 12 at 12 37 06\@2x png when a candidate reaches the stage the take home is assigned to, an activity will show up on their profile indicating that they should be sent an assessment to send an assessment to a candidate, click on start assessment on the activity on the candidate’s profile the candidate will be emailed a link to the selected take home assessment as they complete the assessment, its status will be updated in ashby it may take up to 4 hours for assessment statuses to be reflected in ashby adding interviews adding codesignal interview to schedule interview activities alternatively if you’ve configured codesignal’s interviews option, you can automatically attach live interview pad links to interview invitations when configuring a schedule interview activity if adding the interview to a schedule interview activity, you can enable the attach codesignal interview option on the communications tab the codesignal interview link will be included in both interviewer and candidate invitations cleanshot 2022 12 09 at 15 17 44\@2x png adding codesignal interview to a manually scheduled interview if you’d like to attach a codesignal interview link to an invitation for a one off interview, this can be configured on the communications tab when manually scheduling navigate to the invite settings section and enable the attach codesignal interview? option adding codesignal interview to a one off direct booking link if opting to send out a direct booking link for a one off interview, click on the schedule button on the interview activity then select view all scheduling options head to the template tab, then to communications from there, you will have the option to enable attach codesignal interview? faq does a user need specific permissions in codesignal to create an assessment or interview in ashby? as the assessment is based on generating via the api key, no specific user roles are needed in codesignal