Skip to main content
Signing in to the G-P Developer Portal uses your organization’s single sign-on (SSO) provider. Create the application in the same G-P environment you plan to connect — credentials differ per environment.

​
Creating an API application

Applications on the G-P Developer Portal issue the Client ID and Client Secret that authorize API access. Credentials are not available on the G-P Platform itself.

1

Sign in to G-P

Sign in to the G-P Developer Portal for the environment you are connecting.

2

Open your applications

Open the account menu in the upper right corner and select Applications.

3

Create a new application

On the Applications page, click New application to open the Create an Application form.

4

Enter the application details

Complete the Create an Application form.

  • Application name: StackOne Integration
  • Description: optional — for example, Integration with StackOne
  • Auth strategy is preselected and cannot be changed.
5

Select the application scopes

Enables actions: Download Contract, Download Invoice, Fetch Contract Amendments, Get Change Request, Get Contract, Get Contractor, Get Contractor Contract, Get Current Payroll, Get Customer, Get Employee, Get Employment, Get Employment Compensation, Get Invoice, Get Payroll History, Get Time Off Allowance, List Benefit Enrollments, List Benefit Entitlements, List Change Requests, List Contractor Contracts, List Contractors, List Employees, List Employments, List Invoices, List Jobs, List Time Off Allowances, Submit Change Request

Open Available scopes and select the scopes this integration needs. Use Filter… to narrow the list, and select each scope individually.

6

Create the application and copy the credentials

Click Create application. The Application created successfully dialog displays the credentials for the new application. Copy both values and store them securely for use later.

  • Client ID — the public identifier of the application. Click the copy icon beside it and paste the value into the Client ID field in StackOne Hub.
  • Client secret — the confidential key that authorizes the application. Click the copy icon beside it and paste the value into the Client Secret field in StackOne Hub.
  • The client secret will only be shown once. Please copy this value and keep for your records.
  • Click Copy secret and close to dismiss the dialog.

​
Registering the G-P APIs

An application cannot call an API until that API is registered to it. Register the API sets that cover the scopes you selected.

1

Open the APIs tab

On the application page, open the APIs tab and click Register an API.

2

Register the EOR and Contractor APIs

In the panel that opens, click Register on each API set the integration needs.

  • EOR — covers the employee, employment, contract, job, benefit, payroll, time off, customer, invoice, and change request scopes.
  • Contractor — covers the contractor and contractor contract scopes.
  • In non-production environments the API sets carry an environment suffix, for example EOR - TEST.
  • The Authentication API set cannot be registered — it uses a different authentication strategy.
  • Each API set shows the status Approved once it is registered.

​
Find your Client ID

The Credentials tab of an application lists its Client ID, so you can retrieve it after leaving the creation dialog.

  • Open Applications from the account menu and select your application.
  • Open the Credentials tab.
  • If the client secret was not saved, click Refresh secret to issue a replacement, then paste the new value into the Client Secret field in StackOne Hub.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Client ID
  • Client Secret
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.