---
title: "Create Scanner"
method: POST
path: "/developer/scanners"
tags: ["Developer - Scanners"]
---

# Create Scanner

`POST /developer/scanners`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/developer/scanners`
- Auth: none declared

## Request body

- CreateScanner
  - `customer_id` string, uuid, required
  - `username` string, required
  - `name` string, required
  - `separator_payload` string
  - `customer_path_enabled` boolean
  - `ip_allowlist_enabled` boolean
  - `allowed_ip_networks` string[]

## Response `201`

Successful Response

- CreatedScanner
  - `scanner_id` string, uuid, required
  - `customer_id` string, uuid, required
  - `username` string, required
  - `name` string, required
  - `is_active` boolean, required
  - `customer_path_enabled` boolean, required
  - `customer_folder_path` string, nullable, required
  - `ip_allowlist_enabled` boolean, required
  - `allowed_ip_networks` string[], required
  - `password` string, required
  - `folder_path` string, required

## Other responses

- `422`: Validation Error

## Changes

> 103 revisions in range; 1 not diffed.

- **2026-11-10** `e4448d9de186`: 1 info
  - added the new optional request property `separator_payload`
- **2026-11-10** `52c2b3e60fce`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openintake/apis/openintake-api/changes/developer/scanners/post.md)

---

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