Create Employee Punch [Batch] | Paylocity | Time & Labor Documentation

curl -X POST https://api.paylocity.com/apihub/time/v2/companies/companyId/punchImport \
     -H "Accept: application/json" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "data": [
    {
      "employeeId": "<string>",
      "lastName": "<string>",
      "firstName": "<string>",
      "date": "<string>",
      "time": "<string>",
      "recordType": "<string>",
      "hoursDollars": "<string>",
      "employeeNote": "<string>",
      "supervisorNote": "<string>",
      "payLevel": "<string>",
      "CC1": "<string>",
      "CC2": "<string>",
      "CC3": "<string>",
      "CC4": "<string>",
      "CC5": "<string>",
      "CC6": "<string>",
      "CC7": "<string>",
      "CC8": "<string>",
      "CC9": "<string>",
      "CC10": "<string>",
      "CC11": "<string>",
      "CC12": "<string>",
      "CC13": "<string>",
      "CC14": "<string>",
      "CC15": "<string>"
    },
    {
      "employeeId": "<string>",
      "lastName": "<string>",
      "firstName": "<string>",
      "date": "<string>",
      "time": "<string>",
      "recordType": "<string>",
      "hoursDollars": "<string>",
      "employeeNote": "<string>",
      "supervisorNote": "<string>",
      "payLevel": "<string>",
      "CC1": "<string>",
      "CC2": "<string>",
      "CC3": "<string>",
      "CC4": "<string>",
      "CC5": "<string>",
      "CC6": "<string>",
      "CC7": "<string>",
      "CC8": "<string>",
      "CC9": "<string>",
      "CC10": "<string>",
      "CC11": "<string>",
      "CC12": "<string>",
      "CC13": "<string>",
      "CC14": "<string>",
      "CC15": "<string>"
    }
  ]
}'

Summary Description

The POST Punch Import API endpoint is an API that interfaces with the Paylocity Time and Labor module. The API is designed to streamline importing time data from external systems.

This API offers a method for importing punch data, complementing the other two methods: File import through the application and file import vis SFTP:

The API allows a 62-day window for importing punch data- it accepts data for the previous 31 days, given that the pay periods are open and for the upcoming 31 days.
Any punches outside this timeframe will not be accepted. This feature allows users to seamlessly integrate their time-tracking systems with the Paylocity platform, enhancing efficiency and data accuracy.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

companyIdstringRequired

Request

This endpoint expects an object.

Response

Successful response

Authentication

Path parameters

Headers

Request

Response