Name: PerfectParser
Availability: InStock

`POST /v1/parsers`

Creates a new parser template. If fields is omitted or empty, a blank parser container is created.

Body Parameters

Parameter	Type	Required	Description
`name`	`string`	✅	Unique name for the parser (max 100 chars).
`description`	`string`	❌	Human-readable description.
`result_mode`	`string`	❌	`one_per_file` (default) or `one_per_page`.
`fields`	`array`	❌	List of field definitions containing `name` (required), `type` (optional), and `description` (optional).

curl -X POST https://api.perfectparser.com/v1/parsers \
  -H "X-API-Key: pp_live_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "Invoice Parser", "result_mode": "one_per_file"}'

Response 201 Created

{
  "parser": {
    "parser_id": "prs_999",
    "name": "Invoice Parser",
    "description": null,
    "result_mode": "one_per_file",
    "schema": {},
    "fields": {},
    "has_sample_file": false,
    "created_at": "2026-06-20T10:00:00.000Z",
    "updated_at": "2026-06-20T10:00:00.000Z"
  }
}

Common Error Responses

HTTP Status	Error Code	Description
`400`	`INVALID_PAYLOAD`	Request body validation failed or malformed JSON.
`401`	`UNAUTHORIZED`	Invalid or missing API key.
`409`	`CONFLICT`	A parser with this name already exists.

Create Parser

`POST /v1/parsers`

Common Error Responses

On this page