BuildBetter
Try for free
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.

PROCESS

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
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" }
]
}'

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

What’s next

Feedback + Conversations + Surveys

Connect support platforms, survey tools, and community channels

See all sources

Full API Documentation

Endpoints, authentication, field types, and examples

Open API docs

MCP Integration

Connect AI agents to BuildBetter via MCP

See MCP docs

API Docs

Ready to ingest
feedback via API?

REST API | BuildBetter