---
title: "Import Jobs"
method: POST
path: "/imports/job"
---

# Import Jobs

`POST /imports/job`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/imports/job`
- Auth: API key in header `x-api-key`

Bulk-creates jobs from an uploaded XLSX file. Each sheet name must exactly match an existing Job Category name. Row cap is 1000 per sheet. Validates job_title (required), customer_email (regex), job_type (NEW|REVISIT, defaults NEW), job_priority (HIGH|LOW|MEDIUM|URGENT, defaults LOW), scheduling dates, lat/lon pairing, and — if the first pass has zero errors — a second DB-backed pass validating customer/organization/property/job_status/assigned_user existence and relationships. Jobs are created sequentially; on any validation failure, nothing is created and all accumulated errors are returned together.

## Request body `multipart/form-data`

- object
  - `file` string, binary, required: XLSX workbook, one sheet per Job Category, matching the import template's columns.

## Response `200`

200

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/imports/job/post.md)

---

[API](https://skmtc.dev/zuper/apis/zuper-pro-api.md) - [All operations](https://skmtc.dev/zuper/apis/zuper-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zuper/apis/zuper-pro-api/revisions/3c21bc232e16?raw)