Obtaining OAuth Credentials

Before you can authenticate to Paylocity via OAuth, you must first obtain API access and register your desired callback URL with Paylocity. To do this, contact either [email protected] or [email protected].

Once your access has been reviewed and approved, Paylocity provides you with OAuth credentials and access to either a Sandbox or a Production account. This access is necessary for authenticating your API requests.

Paylocity provides the following OAuth credentials.

• client_id: The client_id assigned to the registered OAuth application in the Paylocity developer portal. This value is used to set the OAuthClientId.
• secret: The secret assigned to the registered OAuth application in the Paylocity developer portal. This value is used to set the OAuthClientSecret.
  Note that Paylocity requires secrets to be rotated every 365 days. They send an email reminder of your secret expiring at 10 days before expiration and again at 5 days before expiration.

You register your desired callback URL with Paylocity, which is used to set the CallbackURL. For example, for a simple desktop application, you can register http://localhost:33333 with Paylocity.