---
title: "Store or update an insight record"
method: POST
path: "/api/{objectName}/{recordId}/insights"
tags: ["Insights Management"]
---

# Store or update an insight record

`POST /api/{objectName}/{recordId}/insights`

## Request

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

This endpoint stores or updates an insight record for a specified object type. If duplicate records are found, the operation is rejected with an appropriate error message.

## Request body

- object
  - `data` string, required: The request payload containing the fields to be saved or updated for the insight.

## Response `200`

Insight saved or updated successfully.

- object
  - `status` string
  - `message` string
  - `data` object
    - `metadata` object
      - `url` string
      - `list_url` string
      - `parent` string
      - `object_type` string
      - `record_type` string
    - `record` object
      - `field1` string
      - `field2` string

## Other responses

- `400`: Invalid record type provided in the request.
- `404`

---

[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)