<aside> 💡 This document details how to set up and use sources to track where candidates are applying from.

</aside>

Section overview:

Source Types and Sources overview

Sources describe where a candidate was introduced to your organization by job consideration (each application has a unique source). Ashby's default source types are Inbound, Internal, Referral, and Sourced.

You have the option to create new top-level source types or sources beneath them. Source types are helpful for grouping sources in reports. Once set up, you'll be able to link sources to candidates, custom tracked links, and API Keys. You can access sources by going to Admin → Organization Setup → Candidate Sources.

https://cdn.zappy.app/43c607d91cf49cd4107247e6da1c3b0b.png

Permissions: Access to Create Sources and Source Types

See the table below for information on the roles that have access to create source types and sources.

Access Role Has Access?
Limited Access
Agency Users
Elevated Access - External Recruiter (not linked to an agency) ❌*
Elevated Access - Analyst ❌*
Elevated Access - Hiring Team Member ❌*
Elevated Access - Hiring Manager ❌*
Elevated Access - Admin ❌*
Elevated Access - Admin Private ❌*
Organization Admin

*Only Organization Admins have access to this feature by default. Elevated Access users can be given access to create candidate sources and source types if needed. More on this at Additional User Permissions.

Add Source Types and Sources

To create a Source Type like the default Inbound and Internal types, click the purple + New Source Type button.

To add a Source, click the purple + New Source button.

https://cdn.zappy.app/aa4149c5e4adf46d17bbfa4c72d71d42.png

https://cdn.zappy.app/f3b15643a0b72ada7d8e5e9966788590.png

Add and view sources on a candidate profile

You can manually add and view sources in the Attribution section in the Activities & Progress section of a candidate profile.

To add or update a source, click the field and select the source from the dropdown menu. If you can't see the one you want, start typing the source name and it will populate.

https://cdn.zappy.app/0f542e14856d677d86701ad10ed96fa3.png

Add a source to a custom tracking link

<aside> 💡 You can read more on setting up custom tracking links at How can I track the source of an application?

</aside>

You can add sources to custom tracking links to automatically apply a source from an external job board. Navigate to Admin → Job Boards → Custom Tracking Links, set up a custom tracked link, and include the source in the appropriate field.

https://cdn.zappy.app/d448ed58e7757871e415cab0e1246675.png

Add a source to an API key

<aside> 💡 You can read more on setting up API keys at [How do I generate an API key?](https://ashbyhq.notion.site/How-do-I-generate-an-API-key-58d3409382014a3d80c3b08e982644d7)

</aside>