# BuildBetter API Documentation

This is the complete API documentation for connecting to the BuildBetter API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **BuildBetter connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/buildBetter/actions/{actionSlug}/run
```

## BuildBetter actions

- POST `create-company` Create Company
- POST `create-person` Create Person
- GET `get-call-by-id` Get Call By ID
- GET `get-call-details-with-participants` Get Call Details With Participants
- GET `get-call-transcript` Get Call Transcript
- GET `get-company-by-id` Get Company By ID
- GET `get-document-by-id` Get Document By ID
- GET `get-person-by-id` Get Person By ID
- GET `get-signal-by-id` Get Signal By ID
- GET `list-calls-by-date-range` List Calls by Date Range
- GET `list-calls-by-participant-email` List Calls by Participant Email
- GET `list-calls-paginated` List Calls Paginated
- GET `list-companies` List Companies
- GET `list-conversations` List Conversations
- GET `list-documents` List Documents
- GET `list-folders` List Folders
- GET `list-people` List People
- GET `list-people-by-company` List People by Company
- GET `list-recent-calls` List Recent Calls
- GET `list-recent-signals` List Recent Signals
- GET `list-signals-by-date-range` List Signals by Date Range
- GET `list-signals-by-sentiment` List Signals by Sentiment
- GET `list-signals-by-type` List Signals by Type
- GET `list-signals-for-call` List Signals for Call
- GET `search-calls-by-title` Search Calls By Title
- GET `search-companies-by-name-or-domain` Search Companies By Name Or Domain
- GET `search-people-by-name` Search People By Name
- GET `search-signals-by-summary-phrase` Search Signals By Summary Phrase
- PUT `update-company` Update Company
- PUT `update-person` Update Person