---
title: "Enqueue a New Automated Job"
method: POST
path: "/jobs/automated"
tags: ["Management"]
---

# Enqueue a New Automated Job

`POST /jobs/automated`

Enqueue an automated job.

`data_sync_all`: Enqueue a job to re-sync all data for a connection. `data_sync_all` has a concurrency limit of 1 job at a time per connection. This means that if this endpoint is called while a job is already in progress for this connection, Finch will return the `job_id` of the job that is currently in progress. Finch allows a fixed window rate limit of 1 forced refresh per hour per connection.

`w4_form_employee_sync`: Enqueues a job for sync W-4 data for a particular individual, identified by `individual_id`. This feature is currently in beta.

This endpoint is available for *Scale* tier customers as an add-on. To request access to this endpoint, please contact your Finch account manager.

## Headers

- `Finch-API-Version` string, date, required
- `Content-Type` string, required

## Request body

- union
  - object
    - `type` 'data_sync_all', required — The type of job to start.
  - object
    - `type` 'w4_form_employee_sync', required — The type of job to start.
    - `params` object, required
      - `individual_id` string, required — The unique ID of the individual for W-4 data sync.

## Response `201`

Created

- AutomatedJobResponse
  - `job_id` string, uuid — The id of the job that has been created.
  - `job_url` string — The url that can be used to retrieve the job status
  - `allowed_refreshes` integer, required — The number of allowed refreshes per hour (per hour, fixed window)
  - `remaining_refreshes` integer, required — The number of remaining refreshes available (per hour, fixed window)
  - `retry_at` string — ISO 8601 timestamp indicating when to retry the request

## Other responses

- `202` — Accepted. This response will be returned if a job is already enqueued for the connection. This case does not consume any job quota as it just returns the details of an existing job.
- `400` — Bad Request
- `401` — Unauthorized
- `429` — Too Many Requests

---

[API](https://skmtc.net/finch-api/apis/api-reference.md) · [All operations](https://skmtc.net/finch-api/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finch-api/api-reference/revisions/20f8dd5faf09/schema)