---
title: "Create a new Feedback Record"
method: POST
path: "/feedbacks"
---

# Create a new Feedback Record

`POST /feedbacks`

## Request body

- object
  - `title` string, nullable — The feedback title, when provided
  - `description` string, required — The feedback content. Can be plain text or include basic HTML elements
  - `isTranscript` boolean, nullable — Whether the feedback is a transcript
  - `tags` string[], nullable — A list of string tags to apply to the feedback. If excluded or null value provided, tags will be auto-generated based on description content.
  - `isExternalContactId` boolean — True if the contactId/contact.id is an external ID, false if it is a Reforge Insights contact ID.
  - `contact` union — The Contact who provided the feedback. If providing an external ID, set isExternalContactId to true.
    - FindOrCreateCustomer, nullable — Used when associating to a new customer, or when not knowing the ID, for which it will be de-duplicated by the email field. The `email` field can be any string, such as a valid email OR a unique identifier from your own system.
      - `name` string
      - `email` string
      - `sourceData` object, nullable — Dictionary to provide other key-value pairs such as the url, identifier, or other information
    - AssociateExistingCustomer, nullable — Used when associating to an existing, known customer, the `id` is the customer ID from Reforge Insights. If the a customer with the provided ID does not exist, the feedback will not be associated to a customer.
      - `id` string — The Reforge Insights ID of the customer
  - `contactId` string, nullable — ID of Contact to associate to. If providing an external ID, set isExternalContactId to true.
  - `isExternalAccountId` boolean — True if the accountId/account.id is an external ID, false if it is a Reforge Insights account ID.
  - `account` union — The customer account to which the feedback should be associated. If providing an external ID, set isExternalAccountId to true.
    - FindOrCreateCustomerAccount, nullable — Used when associating to a new customer account, or when not knowing the ID, for which it will be de-duplicated by the name or domain field. The `name` and 'domain' fields can be any string, such as a valid name/domain OR a unique identifier from your own system.
      - `name` string
      - `domain` string
      - `contractValue` number, nullable
      - `sourceData` object, nullable — Dictionary to provide other key-value pairs such as the url, identifier, or other information
    - AssociateExistingCustomerAccount, nullable — Used when associating to an existing, known customer account, the `id` is the customer account ID from Reforge Insights. If the a customer account with the provided ID does not exist, the feedback will not be associated to a customer account.
      - `id` string — The Reforge Insights ID of the customer account
  - `accountId` string, nullable — ID of CustomerAccount to associate to. If providing an external ID, set isExternalAccountId to true.
  - `source` string, nullable — The source of the feedback. Default: API (when excluded or provided as null
  - `sourceId` string, nullable — A unique identifier for this specific record from the source system (e.g., a Jira ticket key like "ABC-1234", a Zendesk ticket ID, or a Salesforce case number). This is NOT the same as the `source` field—it identifies the individual record, not the integration. Used for deduplication and linking back to the original record.
  - `shouldUnflattenSourceData` boolean, nullable — Whether to unflatten sourceData that are meant to be nested objects for example `{ "plan.type": "Pro" }` will be unflattened to `{ "plan": { "type": "Pro" } }`
  - `sourceData` object, nullable — Dictionary to provide other key-value pairs such as the url, view identifier, or other information
  - `rating` number, nullable — The numeric rating (integer)

## Response `201`

The feedback was created successfully

- object
  - `feedback` Feedback
    - `id` string
    - `description` string
    - `customerId` string
    - `projectId` string
    - `rating` number
    - `sourceId` string
    - `sourceData` object

---

[API](https://skmtc.net/monterey-ai/apis/reforge-insights-formerly-monterey-ai-api.md) · [All operations](https://skmtc.net/monterey-ai/apis/reforge-insights-formerly-monterey-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monterey-ai/reforge-insights-formerly-monterey-ai-api/revisions/fd623cac2355/schema)