Getting started

The AssetCenter customer API lets you read and manage assets, people, locations, and subscriptions, including their assignments, timeline history, to-dos, and lifecycle actions. Use it to connect reporting tools, synchronize inventory, or automate routine updates.

Before you begin#

You need an AssetCenter account and an active account administrator in the organization you want to connect. Create an account from AssetCenter if you do not have one. The user manual explains the records and workflows you will work with.

Open Settings → API Access in the product. Give the token a recognizable name, choose Read Only, Full Access, or Custom permissions, and select an expiry of 30 days, 90 days, or one year. Copy the token immediately: it is shown only once. Store it in your integration’s secret storage.

Start with Read Only for the first requests in the quick start. Create a token with the necessary write or workflow permissions when you are ready to automate changes. Existing tokens retain their original permissions.

Base URL#

https://my.assetcenter.app/api/v1

All endpoint paths in this guide start with /api/v1. Send requests to the product host shown above. This website’s /api pages contain the documentation.

The guide covers the versioned customer integration API. Customer tokens cannot use the unversioned routes used internally by the mobile app, including its login, dashboard, and assistant routes. Create the integration token in Settings instead of calling a login endpoint.

Choose a resource#

Make your first request#

Continue to the quick start to list records and read a timeline. Then review authentication and permissions, pagination, and idempotency before building a recurring integration.