# Twenty API Documentation

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

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

## Twenty actions

- POST `create-company` Create Company
- POST `create-dashboard` Create Dashboard
- POST `create-note` Create Note
- POST `create-object-metadata` Create Object Metadata
- POST `create-opportunity` Create Opportunity
- POST `create-person` Create Person
- POST `create-task` Create Task
- POST `create-workflow` Create Workflow
- DELETE `delete-company` Delete Company
- DELETE `delete-dashboard` Delete Dashboard
- DELETE `delete-note` Delete Note
- DELETE `delete-object-metadata` Delete Object Metadata
- DELETE `delete-opportunity` Delete Opportunity
- DELETE `delete-person` Delete Person
- DELETE `delete-task` Delete Task
- DELETE `delete-workflow` Delete Workflow
- GET `get-company` Get Company
- GET `get-dashboard` Get Dashboard
- GET `get-note` Get Note
- GET `get-object-metadata` Get Object Metadata
- GET `get-opportunity` Get Opportunity
- GET `get-person` Get Person
- GET `get-task` Get Task
- GET `get-workflow` Get Workflow
- GET `list-companies` List Companies
- GET `list-dashboards` List Dashboards
- GET `list-notes` List Notes
- GET `list-object-metadata` List Object Metadata
- GET `list-opportunities` List Opportunities
- GET `list-people` List People
- GET `list-tasks` List Tasks
- GET `list-workflows` List Workflows
- PUT `update-company` Update Company
- PUT `update-dashboard` Update Dashboard
- PUT `update-note` Update Note
- PUT `update-object-metadata` Update Object Metadata
- PUT `update-opportunity` Update Opportunity
- PUT `update-person` Update Person
- PUT `update-task` Update Task
- PUT `update-workflow` Update Workflow