Trimble Unity Construct

The Trimble Unity Construct connector includes modules for projects and processes, users, documents, contacts, and costs.

The Trimble Unity Construct App Xchange connector is ever-evolving to support more API endpoints, Unity Construct modules, and capabilities. While the Unity Construct connector follows the Unity Construct API, it also simplifies some API interactions. It enables actions with a single connector action that may have required as many as 3 or 4 API calls.

It is best to familiarize yourself with the connector modules, data objects, and actions, as well as the respective schemas that accompany them.

User Access

User access, including any development environment needed, is provided by a customer's administrator. Please contact your administrator for individual access.

Engagement and Training

Review the following resources if you need additional product training or want to suggest enhancements for the connector.

• Book a meeting with Professional Services for SaaS Capital Programs

• View Trimble Unity Maintain Training Options

Technical Documentation

Technical documentation for this product is available to registered users.

Connector Endpoints

The documentation below is an OpenAPI description (OAD) of each module in this connector.

Note: This is provided as a quick view of coverage and capabilities. The API and endpoints documented are used internally by the platform and not directly by end users.

• Contacts

• Costs

• Documents

• Projects

• Processes

• Users

Connection in App Xchange

Create an API User

Follow these steps to create an API User account to connect to Trimble Unity Construct.

1. In Unity Construct, navigate to Setup.

2. Under Administration Tools, expand Users and select Manage Users.

3. Select Add.

4. Create a profile for the API User and select Save.

Caution: Do not use an email already affiliated with a human user.

5. Select Manage Membership for the API User.

6. On the Account Roles tab, assign the Account Admin role.

Create an API Key

After creating an API User, follow these steps to create an API key.

1. In Unity Construct, expand APIs under Administration Tools and select Access.

2. Select Create Key.

3. Select API User from the list.

4. Select Download Key.

Your API User is created.

Connector Configuration

When setting up the Trimble Unity Construct connector in App Xchange, enter values in the following fields:

• Name: Enter a descriptive name for your connection.

• API Base URL: Enter the URL for your Unity Construct environment. For example, https://api2.e-builder.net for US1 or https://api2-us2.e-builder.net for US2.

• API User: Enter the API User name you created above.

• API Key: Enter the API key you created above.

Additional Configuration

There are no additional configuration parameters for the connector itself.

User Support

If you encounter a problem or need support for this connector, please visit Trimble Support or email unityconnectorsupport@trimble.com.