# Create Parser

Source: https://www.digiparser.com/docs/api/createParser

# Create Parser

Server URL`loading...`

POST

/`api`/`v1`/`parsers`

Send

Authorization

Body

Create a parser with optional initial fields. To create a document classifier, use `/api/v1/classifiers`.

## [Authorization](#authorization)

`bearerAuth`

authorization<token>

Your API key. Include it directly in the Authorization header as the API key value (e.g., 'authorization: your-api-key-here')

In: `header`

## [Request Body](#request-body)

`application/json`

name\*string

description?string

type?string

acceptedFileTypes?array<string\>

Accepted file MIME type strings.

fields?array<PublicField\>

## [Response Body](#response-body)

### 201

`application/json`

### 400

`application/json`

cURL

JavaScript

Go

Python

Java

C#

```
curl -X POST "https://api.digiparser.com/api/v1/parsers" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
```

201400

```
{
  "id": "d1458cd7-8692-488f-8b3f-0fddade05f9c",
  "name": "Invoice Parser",
  "description": "Extracts purchase order and invoice fields.",
  "type": "document",
  "isActive": true,
  "acceptedFileTypes": [
    {
      "mimeType": "application/pdf",
      "label": "PDF"
    }
  ],
  "settings": {
    "acceptedFileTypes": [
      {
        "mimeType": "application/pdf",
        "label": "PDF"
      }
    ],
    "confidenceScores": {
      "enabled": true
    },
    "markdownParsing": {
      "enabled": true
    },
    "advancedTableExtraction": "disabled",
    "dataExtractionMode": "fast",
    "splitDocuments": {
      "enabled": true,
      "mode": "everyXPages",
      "everyXPages": 5,
      "pageRanges": "1, 3, 7-9",
      "instructions": "Each invoice starts with an invoice number at the top.",
      "partitionKey": "transactions.transaction_date",
      "partitionKeySource": "parserField"
    },
    "classificationGate": {
      "enabled": true,
      "mode": "allow",
      "labels": [
        "Invoice",
        "Purchase Order"
      ],
      "instructions": "Only accept vendor invoices, not support tickets.",
      "costPerDocument": 0.1
    },
    "emailParsing": {
      "parseEmailBody": true,
      "mergeEmailAttachments": true,
      "includeEmailSubjectBody": true,
      "attachmentFileTypes": [
        "string"
      ],
      "senderFilter": {
        "mode": "disabled",
        "rules": [
          {
            "type": "email",
            "value": "[email protected]"
          },
          {
            "type": "domain",
            "value": "example.com"
          }
        ]
      }
    },
    "parsePages": "string"
  },
  "createdAt": "2026-01-23T18:11:47.319Z",
  "updatedAt": "2026-01-23T18:12:29.860Z",
  "counts": {
    "totalDocuments": 128,
    "folders": 4
  }
}
```

```
{
  "error": true,
  "message": "Parser ID mismatch"
}
```

[

Get Parser GET

Retrieve one active document parser by ID. Classifier IDs return a parser-only error; use the classifier APIs for classifiers.

](/docs/api/getParser)[

Update Parser PATCH

Update safe customer-facing parser settings.

](/docs/api/updateParser)