---
title: "Create a batch"
method: POST
path: "/api/lead-gen/batches"
tags: ["Lead Gen"]
---

# Create a batch

`POST /api/lead-gen/batches`

## Request

- Base URL: `https://www.1clickwebsite.ai`
- URL: `https://www.1clickwebsite.ai/api/lead-gen/batches`
- Auth: HTTP bearer

Creates a Lead Gen V2 batch and reserves credits. Standard accounts have a five-credit minimum per batch. Submit 1–500 business rows.

## Request body

- LeadGenBatchCreateRequest
  - `industry` string
  - `rows` LeadGenRow[], required
    - union
      - object
        - `businessName` string, required
        - `business_name` string
        - `phone` string
        - `email` string
        - `address` string
        - `industry` string
        - `logoUrl` string, uri
        - `logo_url` string, uri
        - `primaryColor` string
        - `primary_color` string
        - `backgroundTheme` 'light' | 'dark'
        - `background_theme` 'light' | 'dark'
        - `contactMode` 'form' | 'scheduler' | 'schedule' | 'booking' | 'survey'
        - `contact_mode` 'form' | 'scheduler' | 'schedule' | 'booking' | 'survey'
        - `google_cid` string
        - `google_place_id` string
      - object
        - `businessName` string
        - `business_name` string, required
        - `phone` string
        - `email` string
        - `address` string
        - `industry` string
        - `logoUrl` string, uri
        - `logo_url` string, uri
        - `primaryColor` string
        - `primary_color` string
        - `backgroundTheme` 'light' | 'dark'
        - `background_theme` 'light' | 'dark'
        - `contactMode` 'form' | 'scheduler' | 'schedule' | 'booking' | 'survey'
        - `contact_mode` 'form' | 'scheduler' | 'schedule' | 'booking' | 'survey'
        - `google_cid` string
        - `google_place_id` string
      - object
        - `businessName` string
        - `business_name` string
        - `phone` string
        - `email` string
        - `address` string
        - `industry` string
        - `logoUrl` string, uri
        - `logo_url` string, uri
        - `primaryColor` string
        - `primary_color` string
        - `backgroundTheme` 'light' | 'dark'
        - `background_theme` 'light' | 'dark'
        - `contactMode` 'form' | 'scheduler' | 'schedule' | 'booking' | 'survey'
        - `contact_mode` 'form' | 'scheduler' | 'schedule' | 'booking' | 'survey'
        - `google_cid` string, required
        - `google_place_id` string
      - object
        - `businessName` string
        - `business_name` string
        - `phone` string
        - `email` string
        - `address` string
        - `industry` string
        - `logoUrl` string, uri
        - `logo_url` string, uri
        - `primaryColor` string
        - `primary_color` string
        - `backgroundTheme` 'light' | 'dark'
        - `background_theme` 'light' | 'dark'
        - `contactMode` 'form' | 'scheduler' | 'schedule' | 'booking' | 'survey'
        - `contact_mode` 'form' | 'scheduler' | 'schedule' | 'booking' | 'survey'
        - `google_cid` string
        - `google_place_id` string, required
  - `templateKey` string: Template key returned by `GET /api/lead-gen/templates`.
  - `template_key` string: Snake-case alias of `templateKey`.
  - `primaryColor` string
  - `primary_color` string
  - `backgroundTheme` 'light' | 'dark'
  - `background_theme` 'light' | 'dark'
  - `contactMode` 'form' | 'scheduler' | 'schedule' | 'booking' | 'survey'
  - `contact_mode` 'form' | 'scheduler' | 'schedule' | 'booking' | 'survey'
  - `logoSizePx` integer
  - `logo_size_px` integer

## Response `200`

Batch created

- LeadGenBatchCreateResponse
  - `ok` boolean
  - `batchId` string, uuid
  - `batch` LeadGenBatch
    - `id` string, uuid
    - `status` string
    - `industry` string
    - `template_key` string
    - `total_count` integer
    - `credits_reserved` integer
  - `creditsReserved` integer
  - `creditsRemaining` integer

## Other responses

- `400`: Invalid or missing request data
- `401`: Missing, invalid, or revoked API key
- `403`: Insufficient access, credits, or template availability
- `409`: Retryable credit reservation conflict

---

[API](https://skmtc.dev/1clickwebsite/apis/1clickwebsite-api.md) · [All operations](https://skmtc.dev/1clickwebsite/apis/1clickwebsite-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1clickwebsite/apis/1clickwebsite-api/revisions/e842c9b4e4ec?raw)