---
title: "Create Employee Punch [Batch]"
method: POST
path: "/apihub/time/v2/companies/{companyId}/punchImport"
tags: ["Punch Import"]
---

# Create Employee Punch \[Batch\]

`POST /apihub/time/v2/companies/{companyId}/punchImport`

## Request

- Base URL: `dc1demogwext.paylocity.com` (relative, and the document’s source URL is not known)
- URL: `dc1demogwext.paylocity.com/apihub/time/v2/companies/{companyId}/punchImport`
- Auth: none declared. Required headers: `Authorization`

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

## Path parameters

- `companyId` string, required

## Headers

- `Authorization` string, required

## Request body

- PunchImportRequestV1Model
  - `data` PunchImportRecords[], required
    - `employeeId` string: The employee's employee ID.
    - `lastName` string: Employees Last Name. NOTE: This is just for reference and will not be imported into the system.
    - `firstName` string: Employees First Name. NOTE: This is just for reference and will not be imported into the system.
    - `date` string: Punch Date. Use format MM/DD/YYYY
    - `time` string: Punch Time. Use 12 Hr Format or 24 Hr Format . In addition to Work times, a time is also required for Durations/Dollars/Units entries like PTO, Sick, Bonus, and Mileage. Please feel free to use 12:00 AM in the event that no actual time is present in the system you are exporting from.
    - `recordType` string: In, Out, Transfer, EndLunch, StartLunch, EndBreak, StartBreak. These can be defined on the client level as well.
    - `hoursDollars` string: Total Pay Type Duration or Total Adjustment Amount. This should only be used when importing Duration/Dollars/Units based entries like PTO, Sick, Bonus, Mileage, etc. This field should be left blank for punches.
    - `employeeNote` string: Employee note associated with punch, pay type or adjustment transaction
    - `supervisorNote` string: Supervisor note associated with punch, pay type or adjustment transaction
    - `payLevel` string
    - `CC1` string: Override Value for Cost Center 1. Leave blank for the employee's default Cost Center.
    - `CC2` string: Override Value for Cost Center 2. Leave blank for the employee's default Cost Center.
    - `CC3` string: Override Value for Cost Center 3. Leave blank for the employee's default Cost Center.
    - `CC4` string: Override Value for Cost Center 4. Leave blank for the employee's default Cost Center.
    - `CC5` string: Override Value for Cost Center 5. Leave blank for the employee's default Cost Center.
    - `CC6` string: Override Value for Cost Center 6. Leave blank for the employee's default Cost Center.
    - `CC7` string: Override Value for Cost Center 7. Leave blank for the employee's default Cost Center.
    - `CC8` string: Override Value for Cost Center 8. Leave blank for the employee's default Cost Center.
    - `CC9` string: Override Value for Cost Center 9. Leave blank for the employee's default Cost Center.
    - `CC10` string: Override Value for Cost Center 10. Leave blank for the employee's default Cost Center.
    - `CC11` string: Override Value for Cost Center 11. Leave blank for the employee's default Cost Center.
    - `CC12` string: Override Value for Cost Center 12. Leave blank for the employee's default Cost Center.
    - `CC13` string: Override Value for Cost Center 13. Leave blank for the employee's default Cost Center.
    - `CC14` string: Override Value for Cost Center 14. Leave blank for the employee's default Cost Center.
    - `CC15` string: Override Value for Cost Center 15. Leave blank for the employee's default Cost Center.

## Response `202`

Accepted

- unknown[]
  - unknown

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Server Error

---

[API](https://skmtc.dev/paylocity/apis/punch-import-api.md) - [All operations](https://skmtc.dev/paylocity/apis/punch-import-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/punch-import-api/revisions/a1df6dc0bf1b?raw)