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

# Create a new Feedback Record

`POST /feedbacks`

## Request

- Base URL: `https://insights.reforge.com/api/v1`
- URL: `https://insights.reforge.com/api/v1/feedbacks`
- Auth: HTTP bearer

## 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

## Changes

- **2025-08-06** `f04c65c3d8da`: 2 info
  - added the new optional request property `isExternalAccountId`
  - added the new optional request property `isExternalContactId`
- **2025-03-03** `a0a474d9e231`: 1 info
  - added the new optional request property `isTranscript`
- **2025-02-23** `8caf09b237e7`: 1 info
  - added the new optional request property `shouldUnflattenSourceData`
- **2025-02-20** `9df43bc527f0`: 1 breaking, 4 warning, 3 info
  - removed the enum value `WEB CSV API SLACK TWITTER CHROME_EXTENSION INTERCOM GITHUB WIDGET PORTAL APP_STORE GOOGLE_PLAY DISCORD ZENDESK FRONT SALESFORCE ZAPIER HUBSPOT FANBOOK SALESFORCE_SERVICE_CLOUD ASANA API` of the request property `source`
  - removed the request property `categoryId`
  - removed the request property `customer`
  - removed the request property `priority`
  - …4 more
- **2024-09-06** `35733ff6474b`: 1 info
  - added the new optional request property `account`

[Operation history](https://skmtc.dev/monterey-ai/apis/reforge-insights-formerly-monterey-ai-api/changes/feedbacks/post.md)

---

[API](https://skmtc.dev/monterey-ai/apis/reforge-insights-formerly-monterey-ai-api.md) - [All operations](https://skmtc.dev/monterey-ai/apis/reforge-insights-formerly-monterey-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monterey-ai/apis/reforge-insights-formerly-monterey-ai-api/revisions/fd623cac2355?raw)
