---
title: "Create a job: a batch of actions spread over the account's working window"
method: POST
path: "/api/jobs"
tags: ["jobs"]
---

# Create a job: a batch of actions spread over the account's working window

`POST /api/jobs`

## Request

- Base URL: `https://api.reachmcp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.reachmcp.com/api/jobs`
- Auth: API key in header `X-API-Key`

## Request body

- JobCreateIn: A batch of LinkedIn actions Reach executes over time (see app/services/jobs.py).
  - `account_id` integer, required
  - `action` string, required: send_message | connect | visit_profile | comment_post
  - `items` object[], required: One object per action; fields depend on the action (GET /api/jobs/actions).
  - `label` string, nullable: Free text shown in the dashboard and in webhook events.
  - `window_start` string, nullable: HH:MM in the job's timezone; default 09:00.
  - `window_end` string, nullable: HH:MM in the job's timezone; default 18:00.
  - `days` string[], nullable: Weekdays the job may run, e.g. ["mon", "tue"]; default Monday to Friday.
  - `timezone` string, nullable: IANA zone; default derived from the account's proxy country.

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/reachmcp/apis/mcp-reach.md) · [All operations](https://skmtc.dev/reachmcp/apis/mcp-reach/llms.txt) · [OpenAPI document](https://skmtc.dev/reachmcp/apis/mcp-reach/revisions/1a85fdaf3f7c?raw)