---
title: "Create a new record"
method: POST
path: "/api/{objectNames}/{recordId}/{childObjectName}"
tags: ["Records Management"]
---

# Create a new record

`POST /api/{objectNames}/{recordId}/{childObjectName}`

## Request

- Base URL: `https://api.reallysimplesystems.com`
- URL: `https://api.reallysimplesystems.com/api/{objectNames}/{recordId}/{childObjectName}`
- Auth: HTTP bearer

Creates a new record for the specified object type.

You can also create one or more child records in the same request, in either of two ways:

1. **Nest the child in the request body** — alongside the parent's fields, include a key named after the child object (its singular name, e.g. `contact`) whose value is an object of that child's fields. The parent link field is populated automatically, and each nested child is validated alongside the parent. For example, a `POST /api/accounts` body of `{"Name": "Acme", "contact": {"First": "Jane", "Last": "Doe", "email": "jane@acme.com"}}` creates the account and its contact in a single request. Several different child objects may be nested at once.

2. **Address the parent in the URL** — `POST /api/{objectNames}/{recordId}/{childObjectName}` (e.g. `/api/accounts/95/contacts`) creates a child record under an existing parent record.

When nested children are supplied, any child validation failure returns a `422` with the errors keyed by the child object name, and no records are persisted.

## Request body

- object
  - `data` string, required: The record data to be created, as a flat object of field names and values.
  - `{childObject}` object: Optional. To create a child record together with the parent, include a key named after the child object (its singular name — for example, replace `{childObject}` with `contact`) whose value is an object of that child's fields. The parent link is set for you. Multiple different child objects may be nested in the same request.

## Response `201`

- object
  - `status` string
  - `message` string
  - `data` object
    - `metadata` object
      - `url` string
      - `list_url` string
      - `parent` string, nullable
      - `object_type` string
      - `record_type` string
    - `record` object
      - `salutation` string
      - `accountid` string
      - `first` string
      - `last` string
      - `email` string

## Other responses

- `404`
- `422`

---

[API](https://skmtc.dev/reallysimplesystems/apis/crm-api-documentation.md) · [All operations](https://skmtc.dev/reallysimplesystems/apis/crm-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/reallysimplesystems/apis/crm-api-documentation/revisions/eb046f87bd56?raw)