# Ascora API Documentation

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

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

## Ascora actions

- PUT `add-kits-to-quote` Add Kits To Quote
- PUT `add-labour-to-quote` Add Labour To Quote
- PUT `add-quote-sections` Add Quote Sections
- PUT `add-supplies-to-quote` Add Supplies To Quote
- PUT `add-write-ins-to-quote` Add Write-Ins To Quote
- PUT `clear-quote-items` Clear Quote Items
- POST `create-customer` Create Customer
- POST `create-enquiry` Create Enquiry
- POST `create-full-section-based-quote` Create Full Section-Based Quote
- POST `create-job` Create Job
- POST `create-payment` Create Payment
- POST `create-quote` Create Quote
- POST `create-quote-with-items` Create Quote With Items
- POST `create-supplier` Create Supplier
- POST `create-supplier-invoice` Create Supplier Invoice
- POST `create-webhook-subscription` Create Webhook Subscription
- DELETE `delete-quote-or-section` Delete Quote Or Section
- GET `get-customer` Get Customer
- GET `get-invoices-to-send` Get Invoices To Send
- GET `get-job` Get Job
- GET `get-payments-to-send` Get Payments To Send
- GET `get-quote` Get Quote
- GET `get-supplier-invoice` Get Supplier Invoice
- GET `list-categories` List Categories
- GET `list-contacts` List Contacts
- GET `list-contacts-for-customer` List Contacts For Customer
- GET `list-customers` List Customers
- GET `list-jobs` List Jobs
- GET `list-kits` List Kits
- GET `list-labour-roles` List Labour Roles
- GET `list-quotes` List Quotes
- GET `list-supplier-invoices` List Supplier Invoices
- GET `list-suppliers` List Suppliers
- GET `list-supplies` List Supplies
- PUT `mark-invoices-sent` Mark Invoices Sent
- PUT `mark-payments-sent` Mark Payments Sent
- PUT `update-customer` Update Customer
- PUT `update-quote-status` Update Quote Status
- PUT `update-supplier` Update Supplier
- POST `upsert-contact` Upsert Contact