---
title: "Create a single-keyword job"
method: POST
path: "/api/v1/jobs"
---

# Create a single-keyword job

`POST /api/v1/jobs`

## Request

- Base URL: `https://gmapsleadfinder.com`
- URL: `https://gmapsleadfinder.com/api/v1/jobs`
- Auth: HTTP bearer

## Request body

- object
  - `keyword` string, required: Exactly one Maps search keyword

## Response `200`

Job queued

- CreateJobResponse
  - `jobId` string, uuid, required
  - `keywordCount` integer, required
  - `creditsRemaining` number, required

## Other responses

- `400`: Invalid keyword count
- `401`: Missing or invalid API key
- `402`: No credits remaining
- `403`: Plan cannot use agent API
- `409`: Another job is already running

---

[API](https://skmtc.dev/gmapsleadfinder/apis/gmaps-lead-finder-agent-http-api.md) · [All operations](https://skmtc.dev/gmapsleadfinder/apis/gmaps-lead-finder-agent-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gmapsleadfinder/apis/gmaps-lead-finder-agent-http-api/revisions/8482ef74e4bd?raw)