Skip to main content

Primetric

Primetric is a resource planning and professional services automation platform for software and IT companies, used to manage people, projects, assignments, skills, and time off. This connector uses the Primetric REST API to ingest employees, projects, assignments, organization structure, and related data into Nexla.

Primetric icon

Power end-to-end data operations for your Primetric API with Nexla. Our bi-directional Primetric connector is purpose-built for Primetric, 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 Primetric or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Primetric 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

Prerequisites

The Primetric API uses OAuth2 authentication with the client credentials grant. Before creating a Primetric credential in Nexla, you need to register an API application in Primetric to obtain a client ID and client secret, then exchange them for an access token.

  1. Sign in to Primetric as an administrator.

  2. In the administrator panel, add and authorize a new API Application. Primetric issues a client ID and client secret for the application.

  3. Grant the application the scopes it needs (read, write, and/or finance). The scopes you grant determine which endpoints and fields the application can access.

  4. Request an access token by sending a POST request to the token endpoint https://api.primetric.com/auth/token/ with grant_type=client_credentials, your client_id, client_secret, and the desired scopes. The response contains the OAuth2 bearer access token.

  5. Copy the access token, which you will supply when creating your Nexla credential. Nexla sends this token in the Authorization: Bearer <access_token> header on every request to the Primetric API.

For full details on registering an application, available scopes, and the token endpoint, see the Primetric API documentation.

Authenticate

Credentials required

FieldRequiredSecretDescription
Access TokenYesYesOAuth2 bearer access token obtained from POST https://api.primetric.com/auth/token/ using grant_type=client_credentials with your Primetric client_id and client_secret.

Create a credential in Nexla

  1. After selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.

  2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

  3. Enter your Primetric OAuth2 access token in the Access Token field. This is the bearer token you obtained from the Primetric token endpoint in Prerequisites. Nexla sends it in the Authorization: Bearer <access_token> header on every request to the Primetric API.

    Access tokens issued by the client credentials grant expire. If ingestion begins to fail with authentication errors, request a new access token from https://api.primetric.com/auth/token/ and update this credential. Treat the token as sensitive information and keep it confidential.

    For details about the token endpoint, scopes, and available endpoints, see the Primetric API documentation.

  4. 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.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Primetric connector tile, then select the credential that will be used to connect to Primetric, and click Next; or, create a new Primetric credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Primetric 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.

[Rest API] List Employees

This endpoint template retrieves employees from your Primetric account. Use this template when you need to bring employees into Nexla for analysis, reporting, or integration with other systems.

  • This endpoint issues a GET request to https://api.primetric.com/beta/employees and reads records from the $.results[*] path. Results are paginated, and Nexla automatically pages through the endpoint until no further records are returned.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Organization Clients

This endpoint template retrieves organization clients from your Primetric account. Use this template when you need to bring organization clients into Nexla for analysis, reporting, or integration with other systems.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Organization Company Groups

This endpoint template retrieves organization company groups from your Primetric account. Use this template when you need to bring organization company groups into Nexla for analysis, reporting, or integration with other systems.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Organization Roles

This endpoint template retrieves organization roles from your Primetric account. Use this template when you need to bring organization roles into Nexla for analysis, reporting, or integration with other systems.

  • This endpoint issues a GET request to https://api.primetric.com/beta/organization/roles and reads records from the $.results[*] path. Results are paginated, and Nexla automatically pages through the endpoint until no further records are returned.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Organization Teams

This endpoint template retrieves organization teams from your Primetric account. Use this template when you need to bring organization teams into Nexla for analysis, reporting, or integration with other systems.

  • This endpoint issues a GET request to https://api.primetric.com/beta/organization/teams and reads records from the $.results[*] path. Results are paginated, and Nexla automatically pages through the endpoint until no further records are returned.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Assignments

This endpoint template retrieves assignments from your Primetric account. Use this template when you need to bring assignments into Nexla for analysis, reporting, or integration with other systems.

  • This endpoint issues a GET request to https://api.primetric.com/beta/assignments and reads records from the $.results[*] path. Results are paginated, and Nexla automatically pages through the endpoint until no further records are returned.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Hashtags

This endpoint template retrieves hashtags from your Primetric account. Use this template when you need to bring hashtags into Nexla for analysis, reporting, or integration with other systems.

  • This endpoint issues a GET request to https://api.primetric.com/beta/hash_tags and reads records from the $.results[*] path. Results are paginated, and Nexla automatically pages through the endpoint until no further records are returned.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Organization Departments

This endpoint template retrieves organization departments from your Primetric account. Use this template when you need to bring organization departments into Nexla for analysis, reporting, or integration with other systems.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Organization Identity Providers

This endpoint template retrieves organization identity providers from your Primetric account. Use this template when you need to bring organization identity providers into Nexla for analysis, reporting, or integration with other systems.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Organization Positions

This endpoint template retrieves organization positions from your Primetric account. Use this template when you need to bring organization positions into Nexla for analysis, reporting, or integration with other systems.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Organization Rag Scopes

This endpoint template retrieves organization rag scopes from your Primetric account. Use this template when you need to bring organization rag scopes into Nexla for analysis, reporting, or integration with other systems.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Organization Seniorities

This endpoint template retrieves organization seniorities from your Primetric account. Use this template when you need to bring organization seniorities into Nexla for analysis, reporting, or integration with other systems.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Organization Tags

This endpoint template retrieves organization tags from your Primetric account. Use this template when you need to bring organization tags into Nexla for analysis, reporting, or integration with other systems.

  • This endpoint issues a GET request to https://api.primetric.com/beta/organization/tags and reads records from the $.results[*] path. Results are paginated, and Nexla automatically pages through the endpoint until no further records are returned.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Organization Timeoff Types

This endpoint template retrieves organization timeoff types from your Primetric account. Use this template when you need to bring organization timeoff types into Nexla for analysis, reporting, or integration with other systems.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List People

This endpoint template retrieves people from your Primetric account. Use this template when you need to bring people into Nexla for analysis, reporting, or integration with other systems.

  • This endpoint issues a GET request to https://api.primetric.com/beta/people and reads records from the $.results[*] path. Results are paginated, and Nexla automatically pages through the endpoint until no further records are returned.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Projects

This endpoint template retrieves projects from your Primetric account. Use this template when you need to bring projects into Nexla for analysis, reporting, or integration with other systems.

  • This endpoint issues a GET request to https://api.primetric.com/beta/projects and reads records from the $.results[*] path. Results are paginated, and Nexla automatically pages through the endpoint until no further records are returned.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Projects Vacancies

This endpoint template retrieves projects vacancies from your Primetric account. Use this template when you need to bring projects vacancies into Nexla for analysis, reporting, or integration with other systems.

  • This endpoint issues a GET request to https://api.primetric.com/beta/projects_vacancies and reads records from the $.results[*] path. Results are paginated, and Nexla automatically pages through the endpoint until no further records are returned.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Rag Ratings

This endpoint template retrieves rag ratings from your Primetric account. Use this template when you need to bring rag ratings into Nexla for analysis, reporting, or integration with other systems.

  • This endpoint issues a GET request to https://api.primetric.com/beta/rag_ratings and reads records from the response. The endpoint returns the full result set in a single response and does not require pagination.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Skills

This endpoint template retrieves skills from your Primetric account. Use this template when you need to bring skills into Nexla for analysis, reporting, or integration with other systems.

  • This endpoint issues a GET request to https://api.primetric.com/beta/skills and reads records from the $.results[*] path. Results are paginated, and Nexla automatically pages through the endpoint until no further records are returned.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

[Rest API] List Timeoffs

This endpoint template retrieves timeoffs from your Primetric account. Use this template when you need to bring timeoffs into Nexla for analysis, reporting, or integration with other systems.

  • This endpoint issues a GET request to https://api.primetric.com/beta/timeoffs and reads records from the $.results[*] path. Results are paginated, and Nexla automatically pages through the endpoint until no further records are returned.

The data returned reflects your Primetric organization's data and the scopes granted to the API application used for authentication. For details about response fields and available parameters, see the Primetric API documentation.

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.

Manual configuration

Primetric data sources can also be manually configured to ingest data from any valid Primetric 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 Primetric 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.