Skip to main content
Welcome to the BuildBetter API documentation. The REST API is the supported path for new customer integrations, including creating recordings, attaching media, managing metadata definitions, and reading transcripts by public recording UUID.
The GraphQL API is being deprecated for customer integrations. Move new and existing integrations to the REST API. The GraphQL pages remain available as legacy migration reference while customers transition.
Whether you’re looking to build custom integrations, automate workflows, or extract specific insights, this guide will help you get started and make the most of our API.

​
Getting Started

Authentication & Setup

Learn how to authenticate your REST API requests.

Legacy GraphQL Queries

Reference existing GraphQL integrations while migrating to REST.

Accessing Data Models

Explore the core data types: Calls (Interviews), Signals (Extractions), and Documents.

Recordings REST API

Create recordings, attach media, and fetch transcripts using public UUIDs.

Metadata REST API

Manage source namespaces and typed field definitions for API records.

Legacy GraphQL Examples

See legacy query examples for migration reference.

Error Handling & Best Practices

Learn how to handle API errors and follow best practices for efficient integration.