--- title: "API user" slug: "hexagon-geocloud-api-user" description: "Learn how Hexagon GeoCloud API users enable third-party integrations, manage permissions, secure client credentials, and handle expiration and renewal." tags: ["API Users", "Client Credentials", "User Management"] updated: 2026-10-19T11:44:37Z published: 2026-10-19T11:44:37Z canonical: "rcdocs.leica-geosystems.com/hexagon-geocloud-api-user" --- > ## Documentation Index > Fetch the complete documentation index at: https://rcdocs.leica-geosystems.com/llms.txt > Use this file to discover all available pages before exploring further. # API user An API user lets a third-party web application that embeds Hexagon GeoCloud connect to your company account, without using a person's login credentials. > [!NOTE] > **API users are for integration partners.** API users are intended only for third-party web applications that embed Hexagon GeoCloud. Company admins can create a client ID and client secret for an API user directly in Hexagon GeoCloud. You enter these credentials in your integration partner's application, which then works with your GeoCloud data under the API user's permissions. An API user behaves like any other user for permissions: it appears in the user list, can be given a company role and project roles, can be added to or removed from projects, and can be deleted, which immediately ends its access. Only company admins can create API users. ### Creating an API user 1. Go to the **User management** page of your company account. 2. Click **Create API user**. 3. Read the security notice and click **I agree**. 4. Enter the details: ![Create API User dialog with the Name, E-Mail and Expires on fields, and the Cancel and Create buttons](https://cdn.document360.io/820e11db-8ed5-45ae-ac86-f6b77dcb2aa7/Images/Documentation/hexagon-geocloud-october-19-2026-create-api-user.png) Create API User dialog - **Name**: a name for the API user, for example the name of the partner application. - **Expiration date**: up to one year from today. - **Email address** (optional): not used to sign in. It is only used for notification emails, such as being added to a project. 5. Click **Create**. 6. Copy the **client ID** with **Copy ID** and the **client secret** with **Copy key**, then click **Done**. ![Create API User dialog showing the masked Client ID and Client secret key with the Copy ID and Copy key buttons, a link to the documentation, and the Done button](https://cdn.document360.io/820e11db-8ed5-45ae-ac86-f6b77dcb2aa7/Images/Documentation/hexagon-geocloud-october-19-2026-api-user-credentials.png) Client ID and client secret > [!NOTE] > The client secret is shown only once, when you create the API user. Store it somewhere safe and treat it like a password: anyone who has it can act as the API user. Enter it only in the integration partner's application it's meant for. If you think the credentials have been exposed, delete the API user straight away to end all access. ### Managing an API user An API user appears in your user list marked **API User**. Give it only the company role, projects and project roles it needs. Delete it when you no longer need it. A clock icon next to the API user shows when its credentials expire. It turns orange 30 days before the expiration date and red once they have expired. ![User list row for an API user, with an orange clock icon and API User in the Title column, the company, the Employee role and the delete icon](https://cdn.document360.io/820e11db-8ed5-45ae-ac86-f6b77dcb2aa7/Images/Documentation/hexagon-geocloud-october-19-2026-api-user-list-row.png) API user in the user list, credentials expiring within 30 days ### Expiration and renewal Credentials can't be renewed. Before they expire, create a new API user and enter the new client ID and client secret in your integration partner's application. The credentials stop working within 24 hours after the expiration date. The API user stays in your user list until a company admin deletes it. > [!NOTE] > Uploads, downloads and processing done by an API user count towards your subscription quota, as they do for any other user.