---
title: "Creates a Schema"
method: POST
path: "/api/2026-07-01/resources/custom_resources/schemas"
tags: ["CustomResources > Schema"]
---

# Creates a Schema

`POST /api/2026-07-01/resources/custom_resources/schemas`

Creates a Schema

## Request body

- object
  - `name` string, required — Schema name
  - `company_id` string, required — Company identifier where this schema belongs
  - `effective_at_id` string — Custom field identifier
  - `hidden` boolean, required — Manages visibility of the schema
  - `position` integer — Schema position within employee profile
  - `usage_group_slug` string — Schema slug

## Response `201`

CREATED

- CustomResourcesSchema
  - `id` string, required — Schema identifier
  - `name` string, required — Schema name
  - `company_id` string, required — Company identifier where this schema belongs
  - `hidden` boolean, required — Manages visibility of the schema
  - `position` integer — Schema position within employee profile

---

[API](https://skmtc.net/factorialhr/apis/factorial-api.md) · [All operations](https://skmtc.net/factorialhr/apis/factorial-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/factorialhr/factorial-api/versions/1a6bffb20f7d/schema)