ADP
ADP
ADP: Permissions and setup
Learn how to set up the native ADP integration to automate HR, payroll, and workforce workflows.
The ADP integration connects Atomicwork natively to ADP's APIs for HR, payroll, and workforce management operations. By integrating ADP, your HR and IT teams can automate employee lifecycle events, retrieve employee data, and manage time and attendance directly from Atomicwork.
Permissions
To connect ADP with Atomicwork, you need specific permissions in both platforms:
- Atomicwork permissions: You must have workspace administrator permissions to manage the app store and install the integration. To use ADP in workflows, you need workflow creation and editing permissions.
- ADP permissions: You must register an application in the ADP Developer Portal to obtain OAuth2 client credentials and mTLS certificates. API permissions depend on the scopes and products subscribed to in your ADP account.
Configure the integration
When setting up the integration in Atomicwork, you must provide the following configuration details:
| Field | Required | Description |
|---|---|---|
| Client ID | Yes | Your ADP OAuth2 Client ID. |
| Client Secret | Yes | Your ADP OAuth2 Client Secret. |
| Certificate | Yes | The PEM-encoded X.509 client certificate. |
| Private Key | Yes | The PEM-encoded private key. |
| CA Certificate | No | The PEM-encoded CA certificate from ADP. |
| Token URL | No | Defaults to https://accounts.adp.com/auth/oauth/v2/token. |
| Base URL | No | Defaults to https://api.adp.com. |
Use supported workflow actions
The ADP integration currently exposes one flexible action that allows workflows to make arbitrary HTTP requests to any ADP API endpoint.
Call API action
This action requires the following inputs:
| Input | Required | Description |
|---|---|---|
| HTTP Method | Yes | Select GET, POST, PUT, PATCH, or DELETE. The default is POST. |
| API Endpoint URL | Yes | Enter the full ADP API URL. |
| Request Body | No | Provide the XML or JSON body depending on the ADP endpoint requirements. |
| Headers | No | Supply additional headers as a JSON object. The Authorization header is automatically injected. |
Explore use cases
Since the integration exposes a generic Call API action, you can leverage it for any ADP API endpoint. Practical use cases include:
- Time and attendance management: Submit or retrieve time-off requests, punch data, and schedule information.
- Employee data retrieval: Query employee profiles, demographics, and employment details to enrich service desk requests.
- Payroll operations: Interact with payroll APIs to retrieve pay statements or trigger payroll-related workflows.
- Workforce management automation: Build workflows that automatically create or update records in ADP when triggered by events in Atomicwork.
- Employee onboarding and offboarding: Automate the creation or deactivation of employee records in ADP.
- AI-powered HR assistance: Register ADP as a trusted knowledge source so the AI assistant can reference documentation to answer employee questions.