The Pinpoint integration allows you to automatically post your Pinpoint job openings on Job Today and receive applications from Job Today directly in Pinpoint.
Our Customer Success team will handle the integration setup on the Job Today side. You only need to complete a few steps in your Pinpoint account.
Step 1: Find Your Pinpoint Subdomain
Your Pinpoint subdomain is the first part of your Pinpoint account URL.
For example, if your Pinpoint URL is https://acme.pinpointhq.com, your subdomain is acme.
Share your subdomain with your Job Today Customer Success representative.
Step 2: Create an API Key
Log in to your Pinpoint account.
Navigate to Settings → API & Webhooks.
Make sure the Pinpoint API toggle is enabled.
Open the API Keys tab and create a new API key.
Configure the following permissions:
Job: Read
Answers: Read & Write
Application: Read & Write
Save the API key and share it securely with your Job Today Customer Success representative.
Our team will use your subdomain and API key to register the integration.
Step 3: Create a Webhook
Once the integration is registered, your Job Today Customer Success representative will provide you with a unique webhook URL.
To configure the webhook in Pinpoint:
Navigate to Settings → API & Webhooks → Webhooks.
Click + New webhook.
Enter the webhook URL provided by Job Today.
Save the webhook.
Open the newly created webhook and subscribe to the following events:
Job created
Job updated
Job deleted
Important: Make sure all three events are selected. Creating a webhook without subscribing to events will not trigger job synchronization.
Step 4: Share the Webhook Signing Secret
On the newly created webhook’s page, locate the Signing Secret.
Copy the secret and share it securely with your Job Today Customer Success representative.
This secret allows Job Today to verify that incoming webhook notifications originate from Pinpoint.
Step 5: Integration Activation
Once you have provided the required information, our Customer Success team will complete the setup.
No additional configuration is required on your side.
How the Integration Works
Job synchronization
Job Today reads your jobs through the Pinpoint API. Every job with the status Open and the visibility External is published on Job Today. Draft, closed, and internal-only jobs are not.
A synchronization runs within a few minutes of every webhook notification (job created, updated, or deleted) and, as a safety net, once every night (around 01:30 UTC). Without a webhook, jobs and changes still arrive with the nightly synchronization.
The following details are taken from Pinpoint: the title, the description (the Description, Key responsibilities, Skills, Knowledge & Expertise, and Benefits sections combined), the location, the employment type, the salary (only when it is set to be visible on the posting), and the job's application questions. The job category on Job Today is assigned automatically from the title. Images and videos are not transferred.
To be published, a job needs a title, a description, and a location with a city and a country: the City and Country fields of the job's location record must be filled in; the location name alone is not enough. If the job has a job-feed location (the Town / City and Country fields in the job's Organic job boards section; County / State is optional), Job Today uses it instead of the location record, as other job feeds do. Job Today is a location-based job board, so remote jobs need a location too. A job whose application deadline has passed is not published.
Each job is published under the Job Today user whose email address matches the job's recruitment manager or hiring manager in Pinpoint. When there is no match, the job is published under your company's main account or under a default user agreed with your Customer Success representative.
Pinpoint is the source of truth. Changes made to a job in Pinpoint reach Job Today at the next synchronization, and changes made to the imported job directly on Job Today are overwritten by it. Always edit your jobs in Pinpoint.
Closing or deleting a job in Pinpoint, or changing its visibility to internal, closes it on Job Today. Making it open and external again reopens the same Job Today job, together with the applications it has already received.
Screening questions
The custom questions of the job's application form are imported as screening questions, which candidates answer when they apply on Job Today. Supported question types: short text, long text, number, URL, date, yes/no and multiple choice (including questions limited to a single answer).
Document upload and date range questions cannot be asked on Job Today and are skipped. If such a question is required in Pinpoint, the job is still published, and its applications arrive without an answer to that question. Your Customer Success representative can set the integration to skip these jobs instead.
Conditional (follow-up) questions are imported as optional questions placed right after their parent, with the condition added to the title, for example
If "Yes": Please explain. The answer is sent to Pinpoint only when the condition is met. Follow-ups nested under other follow-ups are not imported.
Candidate applications
Candidates apply to your jobs on Job Today. Each application is sent to Pinpoint automatically as soon as the candidate has answered the screening questions (immediately when the job has none). It appears among the job's applications in Pinpoint with JobToday as the source.
An application carries the candidate's first and last name, email address, phone number, personal summary, town and country (plus the postcode in some countries), a CV in PDF format generated from the candidate's Job Today profile, and the answers to the screening questions. Job Today never shares a candidate's street address.
When the candidate changes an answer later, the existing application in Pinpoint is updated. No duplicate application is created.
Applications flow one way. Reviewing candidates, moving them between stages, rejecting and hiring happen in Pinpoint and are not reflected on Job Today. Messages exchanged with candidates in the Job Today chat are not transferred.
Troubleshooting
👉🏻 A job does not appear on Job Today
Check the following in Pinpoint:
The job's status is Open and its visibility is External.
The job has a title and a description, and its location record has the City and Country fields filled in. The location name alone is not enough. This applies to remote jobs as well.
The application deadline, if any, has not passed.
The webhook is set up and enabled (see the next item). Without it, new jobs appear only after the nightly synchronization.
The API key still exists, and the Pinpoint API toggle is on (Settings → API & Webhooks). A removed key or a switched-off toggle stops both job synchronization and application forwarding until it is restored.
If everything is in place and the job has not appeared by the next day, contact your Customer Success representative. Job filters set up for your account can also exclude a job.
👉🏻 Changes or closures in Pinpoint are not reflected on Job Today
Open the webhook in Settings → API & Webhooks → Webhooks and check that it is enabled and subscribed to Job created, Job updated, and Job deleted.
Pinpoint retries a failed delivery up to 10 times over 24 hours, then disables the webhook and emails you. Fix the cause and enable the webhook again.
Use Send test event on the webhook page. A 2xx response means Job Today accepted the delivery. A 401 response means the webhook URL or the signing secret does not match what Job Today has on file. This happens, for example, when the webhook was deleted and created again, because Pinpoint generates a new signing secret. Send the current signing secret to your Customer Success representative.
Even without a working webhook, changes arrive with the nightly synchronization. Updates that consistently show up only the next day point to a webhook problem.
👉🏻 Changes made on Job Today are reverted
Pinpoint is the source of truth. Job details edited directly on Job Today are overwritten by the next synchronization. Make the change in Pinpoint instead.
👉🏻 Applications do not appear in Pinpoint
Check the API key: it must still exist and have all required permissions, and the Pinpoint API toggle must be on.
Look for the application among the job's applications in Pinpoint; the source is JobToday.
If applications are still missing, contact your Customer Success representative with the job title and the approximate time of the application.
👉🏻 An application shows "-" in the address fields
Job Today shares a candidate's town, country, and postcode but never the street address. When a job asks for an address, "-" is sent in place of the street address and of any other address part the candidate has not provided. To receive applications without placeholders, turn off the address requirement in the job's application settings.
👉🏻 The job shows a different location on Job Today than in Pinpoint
If the Town / City and Country fields in the job's Organic job boards section are filled in (County / State is optional), Job Today uses them instead of the job's location record, like other job feeds do. Clear those fields to publish the location record's address instead.
👉🏻 A screening question is missing on Job Today
Document upload and date range questions, and follow-ups nested under other follow-ups, are not imported. Any other question added or changed in Pinpoint reaches Job Today at the next synchronization.
👉🏻 A candidate's updated answers do not reach Pinpoint
Updating the answers of an application that was already sent needs the Application: Read and Answers: Read and Write permissions on the API key (see Step 2). Without them, new applications still arrive, but later answer changes are not applied. Grant the permissions to the key in Settings → API & Webhooks. Share a new key with your Customer Success representative.
If you encounter any issues during the process, don’t hesitate to contact us! We’ll be happy to help 😊