Build an entirely custom careers page using the Ashby API
4 min
overview if you’re looking to have the most flexibility when it comes to adding your ashby job postings to your external site, you can use the ashby api the full ashby api isn’t intended to be used directly from a browser in these cases, you can opt to proxy the requests through another server or opt to use the lightweight job posting api option more on this at using the lightweight job posting api to list openings on your site docid\ jg1yi4wefy9ghzo 3flgp this approach to posting your jobs to your external careers page is the most amount of effort, but also provides full flexibility in how you design your careers page the ashby api documentation can be found in our developer guides https //developers ashbyhq com/docs/creating a custom careers page companies using this approach posthog https //posthog com/careers for other ways to add your jobs board to your external careers page, please see routes for integrating your ashby job board with your careers page docid 24osjsaqlgxf1p8kq8pqz faq why doesn’t the view posting link within my job posting take me to the specific job posting on my careers page? if you're using a custom careers page powered by ashby's api or an embedded job board, you may notice that clicking the view posting button within a job posting does not automatically route to the job posting on your careers page as expected this behavior is typically related to how your careers page handles url parameters the view posting button relies on the ashby jid url parameter to identify which job to display for example https //yourcompany com/careers?ashby jid=\<job id> for this to work correctly, your careers page needs to include logic that reads the ashby jid parameter and routes the visitor to the corresponding job posting page in most cases, your website should detect the ashby jid parameter in the url match it to the correct job redirect or render the appropriate job details page without this routing logic in place, visitors may be directed to your general careers page instead of the specific role this configuration is managed on your website, so your web or development team needs to implement this routing behavior if you need further information on how ashby provides job identifiers or how to structure the link, feel free to reach out to support