You can embed your Pinpoint job listings on your own website or careers page, using either the HTML widget or the JSON API.
Job listings embedded with either method stay in sync with your Pinpoint account, so candidates always see your current open jobs.
✅ Permissions
You will need access to your website's HTML to embed your job listings. If you're not feeling comfortable doing that, ask a developer or IT administrator to make the changes for you.
Choosing an Embedding Method
Use the table below to decide which method suits your website.
Method | Best for | Customization |
Adding job listings quickly, without writing your own code | Colors and structure, using the widget's settings | |
Creating a fully custom job board | Full control over design and functionality |
Embedding Job Listings with the HTML Widget
To embed job listings using the HTML widget:
Add the following code between the <head> tags of your website's HTML.
<link rel="stylesheet" href="https://dywrfp5ctng3l.cloudfront.net/external-job-postings-table/index.css"> <script type="module" crossorigin src="https://dywrfp5ctng3l.cloudfront.net/external-job-postings-table/index.js"></script>
Add the following code where you want the job listings to appear on your page:
<div data-pinpoint-subdomain="[YOUR_SUBDOMAIN]" data-pinpoint-custom-structure-name="[STRUCTURE_NAME]" data-pinpoint-primary-theme-color="[PRIMARY_COLOR]" data-pinpoint-secondary-theme-color="[SECONDARY_COLOR]" data-pinpoint-highlight-theme-color="[HIGHLIGHT_COLOR]" class="pinpoint-external-jobs-table-widget"></div>
Replace each placeholder in the widget code with your own value.
Save and publish your website changes.
Your job listings will now appear on your website.
Customizing the HTML Widget
You can change how the widget looks by replacing the placeholders in the widget code.
Placeholder | What to enter |
| Your Pinpoint subdomain.
For example, if your Pinpoint URL is acme.pinpointhq.com, enter acme. |
| Name of the custom structure you want the widget to use. |
| Main color for the widget. |
| Secondary color for the widget. |
| Color used to highlight elements in the widget. |
To match your website's design, use the same colors as your website's brand.
Building a Custom Job Board with the JSON API
If you want full control over how your job listings look and work, your developers can use the JSON API to fetch your job data and display it with their own code and styles.
Your jobs endpoint uses this format, with your Pinpoint subdomain in place of [YOUR_SUBDOMAIN]:
https://[YOUR_SUBDOMAIN].pinpointhq.com/postings.json
For full instructions, see the jobs JSON endpoint guide in our developer documentation.