REST API

Feedback Ingestion API

Ingest external feedback data into BuildBetter to analyze alongside your calls and documents. This includes support tickets, NPS surveys, Slack messages, and more.

View full API docs CSV + Adhoc import

Quick start in 3 steps

Get feedback flowing into BuildBetter with three API calls.

Create a feedback source

Define where feedback comes from (Support tickets, NPS, Slack, and more).

Create or update people

Ensure the person exists before ingesting feedback records.

Send feedback records

Ingest structured feedback with content and metadata for analysis.

Authentication and base URL

All requests require an organization API key, sent as a header.

Authentication

Include this header with every request:

X-BuildBetter-Api-Key: ORGANIZATION_API_KEY

Base URL

REST requests are made against:

https://api.buildbetter.app

Core endpoints

Three endpoints to get feedback flowing into BuildBetter in minutes.

Create Feedback Source

Create a new feedback source to categorize ingested data.

POST/v3/rest/feedback-sources

Create or Update Person

Upsert a person record so feedback can be attached to the right identity.

PUT/v3/rest/people

Ingest Feedback Record

Send structured feedback (content + metadata) to a source.

POST/v3/rest/feedback-sources/{id}/records

Example

Ingest a feedback record (example only; see docs for full schema).

curl -X POST https://api.buildbetter.app/v3/rest/feedback-sources/123/records \
  -H "X-BuildBetter-Api-Key: ORGANIZATION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "person_id": 456,
    "display_ts": "2025-01-01T10:30:00Z",
    "external_id": "unique-id-123",
    "fields": [
      { "category": "content", "type": "string", "name": "feedback", "value": "Your actual feedback text here" },
      { "category": "metadata", "type": "string", "name": "priority", "value": "high" }
    ]
  }'

What's next