> ## Documentation Index
> Fetch the complete documentation index at: https://nango-marcin-nan-6306-mcp-tool-connections-get.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# INGENIOUS.BUILD

> Integrate your application with the INGENIOUS.BUILD API

## 🚀 Quickstart

Connect to INGENIOUS.BUILD with Nango and see data flow in 2 minutes. INGENIOUS.BUILD uses OAuth 2.0 client credentials — no user redirect required.

<Steps>
  <Step title="Create the integration">
    In Nango ([free signup](https://app.nango.dev)), go to [Integrations](https://app.nango.dev/dev/integrations) -> *Configure New Integration* -> *INGENIOUS.BUILD*.
  </Step>

  <Step title="Connect your INGENIOUS.BUILD account">
    Go to [Connections](https://app.nango.dev/dev/connections) -> *Add Test Connection*. Enter your Subdomain, Client ID, and Client Secret, then save.
  </Step>

  <Step title="Call the INGENIOUS.BUILD API">
    Make your first request. Replace the placeholders with your [secret key](https://app.nango.dev/dev/environment-settings), [integration ID](https://app.nango.dev/dev/integrations), and [connection ID](https://app.nango.dev/dev/connections):

    <Tabs>
      <Tab title="cURL">
        ```bash theme={null}
        curl "https://api.nango.dev/proxy/api/v2/pub/contacts?page=1&per_page=20" \
          -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
          -H "Provider-Config-Key: <INTEGRATION-ID>" \
          -H "Connection-Id: <CONNECTION-ID>"
        ```
      </Tab>

      <Tab title="Node">
        Install Nango's backend SDK with `npm i @nangohq/node`. Then run:

        ```typescript theme={null}
        import { Nango } from '@nangohq/node';

        const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

        const res = await nango.get({
            endpoint: '/api/v2/pub/contacts',
            params: { page: '1', per_page: '20' },
            providerConfigKey: '<INTEGRATION-ID>',
            connectionId: '<CONNECTION-ID>'
        });

        console.log(res.data);
        ```
      </Tab>
    </Tabs>

    Or fetch credentials with the [Node SDK](/reference/sdks/node#get-a-connection-with-credentials) or [API](/reference/api/connection/get).

    ✅ You're connected! Check the [Logs](https://app.nango.dev/dev/logs) tab in Nango to inspect requests.
  </Step>

  <Step title="Implement Nango in your app">
    Follow our [Auth implementation guide](/guides/auth/auth-guide) to integrate Nango in your app.

    To obtain your own credentials, follow the setup guide linked below.
  </Step>
</Steps>

## 📚 INGENIOUS.BUILD integration guides

Nango maintained guides for common use cases.

* [How do I link my account?](/api-integrations/ingenious-build/connect)
  Create an OAuth application in INGENIOUS.BUILD and obtain credentials to connect it to Nango

Official docs: [INGENIOUS.BUILD API docs](https://api.ingenious.build/docs/oauth-2)

## 🧩 Pre-built syncs & actions for INGENIOUS.BUILD

Enable them in your dashboard. Extend and customize to fit your needs.

### Others

| Function name                      | Description                                                                                                         | Type                                           | Source code                                                                                                                                      |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `archive-employee`                 | Archive an employee (soft-retire, reversible).                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/archive-employee.ts)                 |
| `create-budget-cost-code-category` | Create a cost code category within a budget                                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-budget-cost-code-category.ts) |
| `create-budget-cost-code`          | Create a cost code within a budget cost code category.                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-budget-cost-code.ts)          |
| `create-budget`                    | Create a new budget for a project.                                                                                  | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-budget.ts)                    |
| `create-building`                  | Register a new building/address in the workspace.                                                                   | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-building.ts)                  |
| `create-contact`                   | Create (or find, if matching an existing company by name) a contact and its associated company in one call          | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-contact.ts)                   |
| `create-contract`                  | Create a new contract for a project.                                                                                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-contract.ts)                  |
| `create-contracted-invoice`        | Create a new AP invoice against a contract                                                                          | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-contracted-invoice.ts)        |
| `create-daily-log`                 | Create a new daily log for a project.                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-daily-log.ts)                 |
| `create-employee`                  | Create a new employee record.                                                                                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-employee.ts)                  |
| `create-file`                      | Create a file record by providing a URL for the platform to download from.                                          | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-file.ts)                      |
| `create-project`                   | Create a new project                                                                                                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-project.ts)                   |
| `create-punch-item`                | Create a new punch item on a project.                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-punch-item.ts)                |
| `create-rfi-solution`              | Add a proposed solution/answer to an RFI.                                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-rfi-solution.ts)              |
| `create-rfi`                       | Create a new RFI on a project.                                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-rfi.ts)                       |
| `create-submittal-package`         | Create a new submittal package for a project.                                                                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-submittal-package.ts)         |
| `create-submittal-type`            | Create a new submittal type for a project.                                                                          | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-submittal-type.ts)            |
| `create-submittal`                 | Create a new submittal within a package.                                                                            | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/create-submittal.ts)                 |
| `delete-budget-cost-code`          | Delete a budget cost code                                                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/delete-budget-cost-code.ts)          |
| `get-budget`                       | Get a single budget by id, including its cost code items, categories, and phases.                                   | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/get-budget.ts)                       |
| `get-building`                     | Get a single building by id.                                                                                        | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/get-building.ts)                     |
| `get-company`                      | Get a single company by id.                                                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/get-company.ts)                      |
| `get-contact`                      | Get a single contact by id.                                                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/get-contact.ts)                      |
| `get-contract`                     | Get a single contract by id.                                                                                        | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/get-contract.ts)                     |
| `get-contracted-invoice`           | Get a single contracted invoice by id.                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/get-contracted-invoice.ts)           |
| `get-daily-log`                    | Get a single daily log by id.                                                                                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/get-daily-log.ts)                    |
| `get-employee`                     | Get a single employee by id.                                                                                        | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/get-employee.ts)                     |
| `get-project`                      | Get a single project by id                                                                                          | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/get-project.ts)                      |
| `get-punch-item`                   | Get a single punch item by id.                                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/get-punch-item.ts)                   |
| `get-rfi`                          | Get a single RFI by id.                                                                                             | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/get-rfi.ts)                          |
| `get-submittal`                    | Get a single submittal by id.                                                                                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/get-submittal.ts)                    |
| `list-account-types`               | List the workspace's account types (permission role templates assigned to employees, e.g. Administrator, Standard). | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-account-types.ts)               |
| `list-budgets`                     | List budgets across projects in this workspace.                                                                     | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-budgets.ts)                     |
| `list-buildings`                   | List buildings/addresses registered in this workspace.                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-buildings.ts)                   |
| `list-companies`                   | List companies (vendors, subcontractors, clients, etc) in this workspace.                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-companies.ts)                   |
| `list-contacts`                    | List contacts in this workspace                                                                                     | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-contacts.ts)                    |
| `list-contracted-invoices`         | List AP invoices tied to contracts.                                                                                 | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-contracted-invoices.ts)         |
| `list-contracts`                   | List contracts                                                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-contracts.ts)                   |
| `list-daily-logs`                  | List daily field logs for a project.                                                                                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-daily-logs.ts)                  |
| `list-deleted-resources`           | List resources that have been deleted, optionally filtered by resource type and deletion date range.                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-deleted-resources.ts)           |
| `list-employees`                   | List employees (internal workspace users) in this workspace.                                                        | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-employees.ts)                   |
| `list-projects`                    | List construction/real-estate projects in this workspace.                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-projects.ts)                    |
| `list-punch-items`                 | List punch-list items (deficiency/completion tracking items) for a project.                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-punch-items.ts)                 |
| `list-rfis`                        | List Requests for Information (RFIs) across projects.                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-rfis.ts)                        |
| `list-submittal-packages`          | List submittal packages (groupings of related submittals) for a project.                                            | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-submittal-packages.ts)          |
| `list-submittal-types`             | List submittal types configured for a project                                                                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-submittal-types.ts)             |
| `list-submittals`                  | List submittals for a project.                                                                                      | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-submittals.ts)                  |
| `list-tasks`                       | List schedule tasks for a project.                                                                                  | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/list-tasks.ts)                       |
| `unarchive-employee`               | Restore a previously archived employee.                                                                             | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/unarchive-employee.ts)               |
| `update-budget-cost-code`          | Update an existing budget cost code.                                                                                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/update-budget-cost-code.ts)          |
| `update-company`                   | Update fields on an existing company                                                                                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/update-company.ts)                   |
| `update-contracted-invoice`        | Update fields on an existing contracted invoice.                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/update-contracted-invoice.ts)        |
| `update-employee`                  | Update fields on an existing employee.                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/update-employee.ts)                  |
| `update-project`                   | Update fields on an existing project.                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/actions/update-project.ts)                   |
| `budgets`                          | Sync budgets across projects in this workspace.                                                                     | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/syncs/budgets.ts)                            |
| `buildings`                        | Sync buildings/addresses registered in this workspace.                                                              | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/syncs/buildings.ts)                          |
| `companies`                        | Sync companies (this API's equivalent of vendors/subcontractors/clients) in this workspace.                         | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/syncs/companies.ts)                          |
| `contacts`                         | Sync contacts (individual people) across companies in this workspace.                                               | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/syncs/contacts.ts)                           |
| `contracted_invoices`              | Sync AP invoices tied to contracts                                                                                  | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/syncs/contracted_invoices.ts)                |
| `contracts`                        | Sync contracts across projects                                                                                      | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/syncs/contracts.ts)                          |
| `daily_logs`                       | Sync daily field logs across projects.                                                                              | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/syncs/daily_logs.ts)                         |
| `employees`                        | Sync employee (internal user) records in this workspace.                                                            | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/syncs/employees.ts)                          |
| `projects`                         | Sync construction/real-estate projects in this workspace.                                                           | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/syncs/projects.ts)                           |
| `punch_items`                      | Sync punch-list items (deficiency/completion tracking) across projects.                                             | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/syncs/punch_items.ts)                        |
| `rfis`                             | Sync Requests for Information (RFIs) across projects.                                                               | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/syncs/rfis.ts)                               |
| `submittals`                       | Sync submittals across projects                                                                                     | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/ingenious-build/syncs/submittals.ts)                         |

***
