> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Avoma

> How to integrate Avoma with Admina using an API key. Admina retrieves data such as user names, email addresses, and roles.

## Integration Specifications

<dl />

## Prerequisites

### Getting your API key

1. After logging in to Avoma, select **Developer** under **ORGANIZATION** in **Settings**.

   ![Avoma menu with Developer highlighted](https://mintcdn.com/moneyforwardi/HMJVsV4ldYFlD10J/images/integrations/avoma/settings-developer.png?fit=max\&auto=format\&n=HMJVsV4ldYFlD10J\&q=85\&s=e2ab4aa59c85a3823927fabf07ec9079)

2. On the **Add API Key** screen, enter any name in **Name**, and select **Organization - limited access** in **Scope**.

3. Click **Add API Key**. Store the API key that appears in a safe place, because you use it to set up the integration.

   ![Avoma Add API Key screen with Organization - limited access in Scope and the Add API Key button highlighted](https://mintcdn.com/moneyforwardi/HMJVsV4ldYFlD10J/images/integrations/avoma/add-api-key.png?fit=max\&auto=format\&n=HMJVsV4ldYFlD10J\&q=85\&s=8f26117883c0691187a72e4dc7ceed89)

## Setting up the integration

1. On the integration screen, search for **Avoma**.

2. Enter any string into **Workspace key**. Enter the API key you saved in the previous step into **API key**, and click **Connect**. **Workspace name** is optional.

   ![Avoma integration setup screen showing the Workspace name, Workspace key, and API key fields](https://mintcdn.com/moneyforwardi/HMJVsV4ldYFlD10J/images/integrations/avoma/integrate-workspace.png?fit=max\&auto=format\&n=HMJVsV4ldYFlD10J\&q=85\&s=7f4b9b6460accd69311abccbe667b247)

3. Once the integration with Avoma succeeds, registered user information appears in the account list. If it doesn't complete successfully, first try the steps in [Troubleshoot SaaS integration errors](/en/it-management/saas-management/93nahw45is-trouble). If that doesn't resolve it, check [Information to provide](/en/it-management/saas-management/93nahw45is-trouble#info-to-provide) and contact [support](/en/contact-support).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.