---
title: "Create a page-range splitter draft"
method: POST
path: "/splitters"
tags: ["Splitters"]
---

# Create a page-range splitter draft

`POST /splitters`

## Request

- Base URL: `https://api.pdfparse.net/v1`
- URL: `https://api.pdfparse.net/v1/splitters`
- Auth: HTTP bearer

Create a deterministic splitter that maps one-indexed inclusive page ranges to existing destination tables.

## Headers

- `Idempotency-Key` string: Scopes replay protection to the authenticated project, method, and route for 24 hours.

## Request body

- object
  - `name` string, required
  - `description` string
  - `config` object, required
    - `mode` 'page_range'
    - `overlap_policy` 'exclusive' | 'allowed'
    - `unassigned_policy` 'review' | 'ignore' | 'fallback'
    - `fallback_section_key` string
    - `max_segments` integer
    - `sections` object[], required
      - `section_key` string, required
      - `name` string, required
      - `description` string
      - `destination_table_id` string, required
      - `page_spans` object[], required
        - `start_page` integer, required
        - `end_page` integer, required

## Response `201`

Created

- object
  - `id` string, required
  - `name` string, required
  - `description` string, nullable, required
  - `mode` 'page_range' | 'logical', required
  - `status` 'draft' | 'published' | 'archived', required
  - `draft_revision` integer, required
  - `latest_version` integer, required
  - `config` union, required
    - object
      - `mode` 'page_range'
      - `overlap_policy` 'exclusive' | 'allowed'
      - `unassigned_policy` 'review' | 'ignore' | 'fallback'
      - `fallback_section_key` string
      - `max_segments` integer
      - `sections` object[], required
        - `section_key` string, required
        - `name` string, required
        - `description` string
        - `destination_table_id` string, required
        - `page_spans` object[], required
          - `start_page` integer, required
          - `end_page` integer, required
    - object
      - `mode` 'logical', required
      - `sourceInboxId` string, nullable, required
      - `instructions` string, required
      - `sectionTypes` object[], required
        - `key` string, required
        - `name` string, required
        - `description` string
      - `routingMode` 'project_rules', required
      - `reviewUncertainBoundaries` boolean, required
      - `reviewUncertainDestinations` boolean, required
      - `boundaryConfidenceThreshold` integer
      - `maxSegments` integer
  - `created_at` string, nullable, required
  - `updated_at` string, nullable, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `500`: Workflow error

---

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