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

# Create a record

`POST /modules/{moduleId}/records`

## Request

- Base URL: `https://api.teamo360.com/api/v1`
- URL: `https://api.teamo360.com/api/v1/modules/{moduleId}/records`
- Auth: HTTP bearer

Full write pipeline: propagation, change log, webhooks, automations. Supports Idempotency-Key header (24h replay window). Optional shortcuts: `status` sets the module's status column (option label or id) and `assigneeId` its owner column (a user id); null clears the cell. A module without that column ignores the shortcut, and a value in `fields` for the same column wins. Same on batch items.

Requires the `data:write` token scope.

## Path parameters

- `moduleId` string, required

## Query parameters

- `typecast` string

## Request body

- object

## Response `200`

Success

## Other responses

- `400`: Malformed parameters or body
- `401`: Missing, invalid, expired, or legacy token
- `403`: Blocked by role, token scope, module grant, or org policy
- `404`: Entity missing or outside the principal’s access
- `429`: Rate limit exceeded - see Retry-After

---

[API](https://skmtc.dev/teamo360/apis/teamo-public-api.md) · [All operations](https://skmtc.dev/teamo360/apis/teamo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/teamo360/apis/teamo-public-api/revisions/32528ecbc4f4?raw)