Pinpoint is an applicant tracking system (ATS) and recruitment platform that helps talent teams attract, hire, and onboard candidates. Its REST API exposes recruiting data such as candidates, jobs, applications, requisitions, interviews, scorecards, and the rest of the hiring pipeline, letting you sync that data into your analytics and reporting workflows.
Power end-to-end data operations for your Pinpoint API with Nexla. Our bi-directional Pinpoint connector is purpose-built for Pinpoint, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Pinpoint or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Pinpoint workflows fast, secure, and fully governed.
Features
Type: API
SourceDestination
Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
Request optimization with intelligent batching, retry, and caching to minimize API calls and costs
Before creating a Pinpoint credential, you need an API key from your Pinpoint account and your account subdomain. Pinpoint authenticates every API request with an API key sent in the X-API-KEY header, and all requests are made against your account's own subdomain (for example, https://mycompany.pinpointhq.com/api/v1/).
To generate a Pinpoint API key, follow these steps:
Sign in to Pinpoint with an account that has Company Manager permission, which is required to create and manage API keys.
Navigate to Settings > API & Webhooks.
Toggle the Pinpoint API option to enable it if it is not already active.
Click + Create New to begin creating a new API key.
Enter a descriptive name for the key (for example, "Nexla Integration").
Configure the permissions for the key by selecting Read, Write, or Delete for each function as needed. For ingesting data into Nexla, Read access to the objects you plan to sync is sufficient.
Click Create API Key.
On the confirmation screen, click the eye icon to reveal the key and the copy icon to copy it. Store the key securely, as it grants access to your Pinpoint account data.
Determine your account subdomain from the URL you use to access Pinpoint. If you access Pinpoint at https://mycompany.pinpointhq.com, then your subdomain is mycompany.
Keep your API key confidential. Do not expose it in publicly accessible locations such as source-code repositories or client-side code. If a key is compromised, remove it from Settings > API & Webhooks immediately and generate a new one.
After selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.
Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.
Enter your Pinpoint API key in the API Key field. This key is sent in the X-API-KEY header for all API requests and must be kept confidential.
Enter your Pinpoint account subdomain in the Account Subdomain field. Nexla uses this value to construct the API base URL for your account (for example, https://mycompany.pinpointhq.com/api/v1/).
Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source creation.
To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Pinpoint connector tile, then select the credential that will be used to connect to your Pinpoint account, and click Next; or, create a new Pinpoint credential for use in this flow.
Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Pinpoint endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.
List Candidates
This endpoint template retrieves a list of all candidates in your Pinpoint account. Use it to sync candidate records for reporting, analytics, or downstream integrations.
This endpoint returns all candidates accessible to your API key, retrieved from the /api/v1/candidates endpoint.
Fetch Candidate
This endpoint template retrieves a single candidate by ID. Use it when you need the full record for one specific candidate.
Enter the Pinpoint candidate ID in the Record ID field. This is a required parameter that identifies the candidate to fetch from the /api/v1/candidates/{'{id}'} endpoint.
List Jobs
This endpoint template retrieves a list of all jobs in your Pinpoint account. Use it to sync open and historical job postings for reporting and analysis.
This endpoint returns all jobs accessible to your API key, retrieved from the /api/v1/jobs endpoint.
Fetch Job
This endpoint template retrieves a single job by ID. Use it when you need the full record for one specific job.
Enter the Pinpoint job ID in the Record ID field. This is a required parameter that identifies the job to fetch from the /api/v1/jobs/{'{id}'} endpoint.
List Applications
This endpoint template retrieves a list of all applications, which link a candidate to a job and a hiring-pipeline stage. Use it to track application activity across your pipeline.
This endpoint returns all applications accessible to your API key, retrieved from the /api/v1/applications endpoint.
Fetch Application
This endpoint template retrieves a single application by ID. Use it when you need the full record for one specific application.
Enter the Pinpoint application ID in the Record ID field. This is a required parameter that identifies the application to fetch from the /api/v1/applications/{'{id}'} endpoint.
List Positions
This endpoint template retrieves a list of all positions, which represent individual headcount instances under a job. Use it to analyze headcount and open roles.
This endpoint returns all positions accessible to your API key, retrieved from the /api/v1/positions endpoint.
Fetch Position
This endpoint template retrieves a single position by ID. Use it when you need the full record for one specific position.
Enter the Pinpoint position ID in the Record ID field. This is a required parameter that identifies the position to fetch from the /api/v1/positions/{'{id}'} endpoint.
List Requisitions
This endpoint template retrieves a list of all hiring requisitions. Use it to sync requisition data for approval tracking and workforce planning.
This endpoint returns all requisitions accessible to your API key, retrieved from the /api/v1/requisitions endpoint.
Fetch Requisition
This endpoint template retrieves a single requisition by ID. Use it when you need the full record for one specific requisition.
Enter the Pinpoint requisition ID in the Record ID field. This is a required parameter that identifies the requisition to fetch from the /api/v1/requisitions/{'{id}'} endpoint.
List Departments
This endpoint template retrieves a list of all departments in your Pinpoint account. Use it to enrich hiring data with organizational structure.
This endpoint returns all departments accessible to your API key, retrieved from the /api/v1/departments endpoint.
List Divisions
This endpoint template retrieves a list of all divisions in your Pinpoint account. Use it to enrich hiring data with organizational structure.
This endpoint returns all divisions accessible to your API key, retrieved from the /api/v1/divisions endpoint.
List Locations
This endpoint template retrieves a list of all locations in your Pinpoint account. Use it to associate jobs and candidates with geographic locations.
This endpoint returns all locations accessible to your API key, retrieved from the /api/v1/locations endpoint.
List Users
This endpoint template retrieves a list of all Pinpoint users, such as recruiters and members of the hiring team. Use it to attribute hiring activity to specific team members.
This endpoint returns all users accessible to your API key, retrieved from the /api/v1/users endpoint.
List Interviews
This endpoint template retrieves a list of all scheduled interviews. Use it to track interview scheduling and pipeline progress.
This endpoint returns all interviews accessible to your API key, retrieved from the /api/v1/interviews endpoint.
List Scorecards
This endpoint template retrieves a list of all interview scorecards. Use it to analyze interviewer feedback and evaluation data.
This endpoint returns all scorecards accessible to your API key, retrieved from the /api/v1/scorecards endpoint.
List Comments
This endpoint template retrieves a list of all comments left on applications. Use it to capture hiring-team notes and collaboration history.
This endpoint returns all comments accessible to your API key, retrieved from the /api/v1/comments endpoint.
List Custom Fields
This endpoint template retrieves a list of all custom field definitions configured in your Pinpoint account. Use it to understand the structure of custom data captured in your workflows.
This endpoint returns all custom field definitions accessible to your API key, retrieved from the /api/v1/custom_fields endpoint.
List Custom Attributes
This endpoint template retrieves a list of all custom attribute values. Use it to sync the custom data recorded against records in your Pinpoint account.
This endpoint returns all custom attribute values accessible to your API key, retrieved from the /api/v1/custom_attributes endpoint.
List Job Seekers
This endpoint template retrieves a list of all job seeker portal accounts. Use it to analyze candidate engagement through the job seeker portal.
This endpoint returns all job seeker accounts accessible to your API key, retrieved from the /api/v1/job_seekers endpoint.
List Hiring Workflows
This endpoint template retrieves a list of all hiring workflow templates, which define the pipeline stages used across your jobs. Use it to map applications to their pipeline structure.
This endpoint returns all hiring workflow templates accessible to your API key, retrieved from the /api/v1/hiring_workflows endpoint.
List Job Templates
This endpoint template retrieves a list of all job templates. Use it to understand the reusable job definitions configured in your account.
This endpoint returns all job templates accessible to your API key, retrieved from the /api/v1/job_templates endpoint.
List Requisition Templates
This endpoint template retrieves a list of all requisition templates. Use it to understand the reusable requisition definitions configured in your account.
This endpoint returns all requisition templates accessible to your API key, retrieved from the /api/v1/requisition_templates endpoint.
List Access Groups
This endpoint template retrieves a list of all access groups. Use it to audit permission groupings across your Pinpoint account.
This endpoint returns all access groups accessible to your API key, retrieved from the /api/v1/access_groups endpoint.
List Background Checks
This endpoint template retrieves a list of all background checks. Use it to track background-check status across candidates in your pipeline.
This endpoint returns all background checks accessible to your API key, retrieved from the /api/v1/background_checks endpoint.
List Candidate Assessments
This endpoint template retrieves a list of all candidate assessments. Use it to analyze assessment results captured during the hiring process.
This endpoint returns all candidate assessments accessible to your API key, retrieved from the /api/v1/candidate_assessments endpoint.
List Candidate Surveys
This endpoint template retrieves a list of all candidate experience surveys. Use it to analyze candidate feedback about your hiring process.
This endpoint returns all candidate surveys accessible to your API key, retrieved from the /api/v1/candidate_surveys endpoint.
List Onboarding Applications
This endpoint template retrieves a list of all applications currently in onboarding. Use it to track new hires progressing through onboarding.
This endpoint returns all onboarding applications accessible to your API key, retrieved from the /api/v1/onboarding_applications endpoint.
List Structured Sections
This endpoint template retrieves a list of all structured application-form sections. Use it to understand how application forms are structured in your account.
This endpoint returns all structured sections accessible to your API key, retrieved from the /api/v1/structured_sections endpoint.
Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.
Pinpoint data sources can also be manually configured to ingest data from any valid Pinpoint API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.
Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Pinpoint data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.
