---
title: "Create a record"
method: POST
path: "/modules/{moduleSlug}/records"
tags: ["Records"]
---

# Create a record

`POST /modules/{moduleSlug}/records`

## Request

- Base URL: `https://api.getcoherence.io/v1`
- URL: `https://api.getcoherence.io/v1/modules/{moduleSlug}/records`
- Auth: HTTP bearer

Requires the `records:write` scope.

## Request body

- RecordCreate
  - `displayName` string, required
  - `fields` object: Field values keyed by field key.
  - `ownerUserId` string, uuid

## Response `201`

Created record

- object
  - `record` Record
    - `recordId` string, uuid
    - `moduleId` string, uuid
    - `moduleSlug` string
    - `displayName` string
    - `fields` object
    - `createdDateTime` string, date-time
    - `updatedDateTime` string, date-time

## Other responses

- `400`: The request body failed validation.
- `401`: Authentication failed or missing.

---

[API](https://skmtc.dev/getcoherence/apis/coherence-api.md) · [All operations](https://skmtc.dev/getcoherence/apis/coherence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getcoherence/apis/coherence-api/revisions/622d56f657b1?raw)