Skip to main content
POST
Create feedback

Authorizations

x-api-key
string
header
required

Your Lane API key, sent in the x-api-key header.

Body

application/json
title
string
required

Short title of the feedback. Required and must not be blank.

description
string

The body of the feedback. When present, the feedback is queued for AI insight extraction.

customer_email
string

The email of the person who gave the feedback. Links the feedback to that person (added if new) and, when no company is named, to their company: the one they already belong to in Lane, or the one their email's domain names (added if new). Personal domains such as gmail.com don't name a company.

Example:

"jane@acme.com"

customer_name
string

The person's name. Kept on the feedback as who it's from, and saved on the person in Lane when they have no name yet. A name already set is never changed.

company_domain
string

The website domain of the company the feedback is from. Lane uses the company with that domain, or adds it. A URL works too: https://www.acme.com/pricing is read as acme.com. The most reliable way to name a company. Skipped, with a warning, when it's a personal email domain or not a domain.

Example:

"acme.com"

company_name
string

The company's name, for when you don't have its domain. Matched exactly, ignoring case and extra spaces; added as a new company when none matches. Skipped, with a warning, when several companies share the name. Sent with company_domain, it's the name given to the company if Lane adds it.

Example:

"Acme"

created_at
string

When the feedback was given, if not now. An ISO 8601 date (2026-03-04, read as midnight UTC) or date-time (2026-03-04T10:00:00Z, or with an offset such as +05:30; with no offset it's read as UTC). Saved as the feedback's createdAt, so trends and lists place it on that date. Left out, the feedback is dated when it's created.

A value Lane can't use is skipped with a warning, and the feedback is dated when it's created: another format (03/04/2026), a day that doesn't exist, a date before 2000, or one more than a week in the future. A date up to a week ahead (from a timezone ahead of UTC) is dated now without a warning.

Example:

"2026-03-04"

source
string

Origin label for the feedback (for example, "Zapier" or "Chrome"). Normalized against the allowed set; defaults to "Manual".

Response

Feedback created.

id
string
title
string
description
string
status
string

Workflow status label.

customer
string | null

The name of the company the feedback is linked to, if any.

customer_email
string | null

The email of who the feedback is from, as sent.

source
string
createdAt
string<date-time>

When the feedback was given: created_at if you sent one, otherwise when it was created.

updatedAt
string<date-time>

When the feedback was last changed. For new feedback, when it was created.

company
object | null

The company the feedback is linked to, or null.

warnings
string[]

What Lane couldn't use from the request and why, in plain sentences. Empty when everything was used as sent.