---
title: "Create Foundational Data"
method: POST
path: "/api/v2/ats/foundational-data"
tags: ["Foundational Data"]
---

# Create Foundational Data

`POST /api/v2/ats/foundational-data`

Create a new foundational data object

## Headers

- `Authorization` string, required

## Request body

- FoundationalDataCreateRequestSchema
  - `externalId` string, required — External ID of the foundational data
  - `status` string, required — Status of the foundational data
  - `parents` ParentOrgUnitSchema[], required — List of parent org units; must contain at least one {externalId, viewId} pair
    - `externalId` string, nullable — External ID; null or omitted signals a root node in the given view
    - `viewId` string, required — View ID
  - `type` string, required — Type of the foundational data
  - `users` FoundationalDataUserSchema[], nullable — List of users
    - `role` string, required — User role
    - `email` string, required — User email
  - `attributes` FoundationalDataAttributeSchema[], nullable — List of attributes
    - `value` string, nullable — Attribute value
    - `attributeId` string, required — Attribute ID
  - `description` string, nullable — Description of the foundational data
  - `title` string, required — Title of the foundational data

## Response `200`

OK

- FoundationalDataResponseSchema
  - `externalId` string, nullable — External ID of the foundational data
  - `status` string, nullable — Status of the foundational data
  - `createdAt` integer, nullable — Created timestamp
  - `parents` ParentOrgUnitSchema[], nullable — List of parent org units
    - `externalId` string, nullable — External ID; null or omitted signals a root node in the given view
    - `viewId` string, required — View ID
  - `type` string, nullable — Type of the foundational data
  - `updatedAt` integer, nullable — Updated timestamp
  - `users` FoundationalDataUserSchema[], nullable — List of users
    - `role` string, required — User role
    - `email` string, required — User email
  - `attributes` FoundationalDataAttributeSchema[], nullable — List of attributes
    - `value` string, nullable — Attribute value
    - `attributeId` string, required — Attribute ID
  - `description` string, nullable — Description of the foundational data
  - `title` string, nullable — Title of the foundational data

---

[API](https://skmtc.net/eightfold/apis/api-server-v2-service-service.md) · [All operations](https://skmtc.net/eightfold/apis/api-server-v2-service-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eightfold/api-server-v2-service-service/versions/0fb26f4e41bf/schema)