> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laneapp.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Create feedback

> Creates a piece of feedback in Lane. If a `customer_email` is supplied, Lane resolves the contact and account automatically — matching an existing contact by email, creating one if needed, and grouping it under a company by email domain. When a `description` is present, the feedback is queued for AI processing (insight extraction).



## OpenAPI

````yaml /openapi.json post /records/feedback
openapi: 3.1.0
info:
  title: Lane Public API
  version: 1.0.0
  description: >-
    Programmatic access to Lane — create customer feedback and read your
    signals. This is the same API that powers the Lane Zapier app and Chrome
    extension, and you can use it for any custom integration.


    All requests are scoped to the workspace that owns the API key. The Public
    API is available on the Pro and Business plans.
servers:
  - url: https://api.laneapp.co/api
    description: Production
security:
  - ApiKeyHeader: []
  - BearerAuth: []
tags:
  - name: Connection
    description: Test that your API key is valid.
  - name: Feedback
    description: Create customer feedback in Lane.
  - name: Signals
    description: Read the signals detected in your workspace.
paths:
  /records/feedback:
    post:
      tags:
        - Feedback
      summary: Create feedback
      description: >-
        Creates a piece of feedback in Lane. If a `customer_email` is supplied,
        Lane resolves the contact and account automatically — matching an
        existing contact by email, creating one if needed, and grouping it under
        a company by email domain. When a `description` is present, the feedback
        is queued for AI processing (insight extraction).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFeedbackRequest'
            example:
              title: CSV export is too slow
              description: Exporting a large report times out after 30 seconds.
              customer_email: jane@acme.com
              customer_name: Jane Doe
              source: Zapier
      responses:
        '200':
          description: Feedback created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Feedback'
              example:
                id: 66a1b2c3d4e5f6a7b8c9d0e1
                title: CSV export is too slow
                description: Exporting a large report times out after 30 seconds.
                status: Triage
                customer: Acme Inc
                customer_email: jane@acme.com
                source: Zapier
                importance: null
                createdAt: '2026-07-04T10:00:00.000Z'
                updatedAt: '2026-07-04T10:00:00.000Z'
        '400':
          description: Validation error — for example, a missing or blank title.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Title is required
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    CreateFeedbackRequest:
      type: object
      required:
        - title
      properties:
        title:
          type: string
          description: Short title of the feedback. Required and must not be blank.
        description:
          type: string
          description: >-
            The body of the feedback. When present, the feedback is queued for
            AI insight extraction.
        customer_email:
          type: string
          description: >-
            If provided, links the feedback to a contact (matched or created by
            email) and to a company (by email domain).
        customer_name:
          type: string
          description: Used alongside customer_email when creating a new contact.
        source:
          type: string
          description: >-
            Origin label for the feedback (for example, "Zapier" or "Chrome").
            Normalized against the allowed set; defaults to "Manual".
    Feedback:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        description:
          type: string
        status:
          type: string
          description: Workflow status label.
        customer:
          type: string
          nullable: true
          description: The linked account name, if resolved.
        customer_email:
          type: string
          nullable: true
        source:
          type: string
        importance:
          type: string
          nullable: true
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
    Error:
      type: object
      properties:
        success:
          type: boolean
        error:
          type: string
        message:
          type: string
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Lane API key, sent in the `x-api-key` header.
    BearerAuth:
      type: http
      scheme: bearer
      description: 'Your Lane API key, sent as `Authorization: Bearer <key>`.'

````