# Harvestr.io API Documentation

This is the complete API documentation for connecting to the Harvestr.io 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 **Harvestr.io connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

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

## Harvestr.io actions

- POST `create-company` Create Company
- POST `create-feedback` Create Feedback
- POST `create-message` Create Message
- POST `create-user` Create User
- GET `get-discovery-state` Get Discovery State
- GET `list-companies` List Companies
- GET `list-company-attribute-values` List Company Attribute Values
- GET `list-company-attributes` List Company Attributes
- GET `list-components` List Components
- GET `list-custom-inboxes` List Custom Inboxes
- GET `list-discoveries` List Discoveries
- GET `list-discovery-feedback` List Discovery Feedback
- GET `list-discovery-states` List Discovery States
- GET `list-feedback` List Feedback
- GET `list-message-feedback` List Message Feedback
- GET `list-messages` List Messages
- GET `list-user-attribute-values` List User Attribute Values
- GET `list-user-attributes` List User Attributes
- GET `list-users` List Users
- GET `retrieve-company` Retrieve Company
- GET `retrieve-component` Retrieve Component
- GET `retrieve-discovery` Retrieve Discovery
- GET `retrieve-discovery-state` Retrieve Discovery State
- GET `retrieve-feedback` Retrieve Feedback
- GET `retrieve-message` Retrieve Message
- GET `retrieve-user` Retrieve User
- PUT `update-company` Update Company
- PUT `update-company-attribute-values` Update Company Attribute Values
- PUT `update-discovery` Update Discovery
- PUT `update-message` Update Message
- PUT `update-user` Update User
- PUT `update-user-attribute-values` Update User Attribute Values