> ## 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.

# Buildkite

> How to integrate Buildkite with Admina using an API key. Admina retrieves data such as user names, email addresses, and roles and supports account creation and deletion.

## Integration Specifications

<dl />

## Prerequisites

### How to obtain an API access token

1. Log in to [Buildkite](https://buildkite.com) and check that the organization to connect is selected at the top of the screen. Open the profile menu at the top right and click **Personal settings**.

   ![The Buildkite profile menu with Personal settings highlighted](https://mintcdn.com/moneyforwardi/-Ff5k1r2A7v3Udje/images/integrations/buildkite/buildkite-personal-settings.png?fit=max\&auto=format\&n=-Ff5k1r2A7v3Udje\&q=85\&s=e3e601849ac99bb804270b608d57d19c)

2. Select **API Access Tokens** in the left menu.

   ![The left menu of Buildkite personal settings with API Access Tokens highlighted](https://mintcdn.com/moneyforwardi/-Ff5k1r2A7v3Udje/images/integrations/buildkite/buildkite-api-access-tokens-menu.png?fit=max\&auto=format\&n=-Ff5k1r2A7v3Udje\&q=85\&s=b4b6898546580e51506e5bd78a50d06d)

3. Click **New API Access Token**.

   ![The Buildkite API Access Tokens screen with the New API Access Token button highlighted](https://mintcdn.com/moneyforwardi/-Ff5k1r2A7v3Udje/images/integrations/buildkite/buildkite-new-api-access-token.png?fit=max\&auto=format\&n=-Ff5k1r2A7v3Udje\&q=85\&s=622604dff316f251fb2d4f824f7e5b47)

4. Enter a name in **Description** that shows what the token is for. Under **Organization Access**, select the organization to connect. For **Token Expiry**, select **Never**. The image shows **7 days** selected. If you choose a period such as 7 days, the integration stops when the token expires.

   ![The Buildkite New API Access Token screen with Description, Organization Access, and Token Expiry highlighted](https://mintcdn.com/moneyforwardi/-Ff5k1r2A7v3Udje/images/integrations/buildkite/buildkite-create-token-settings.png?fit=max\&auto=format\&n=-Ff5k1r2A7v3Udje\&q=85\&s=d25a29c3667b15b03e8367fce5fbd31a)

5. Under **REST API Scopes**, open **Organization & Users**. Select both **Read** and **Write** for **Organizations** and **Organization Invitations**, and select **Read** for **Teams**. Do not select any other item. The image shows every item selected and highlights **Write** for **Teams**, but **Write** for **Teams** is not required.

   ![The Read and Write checkboxes for Organizations, Organization Invitations, and Teams highlighted](https://mintcdn.com/moneyforwardi/-Ff5k1r2A7v3Udje/images/integrations/buildkite/buildkite-token-scopes.png?fit=max\&auto=format\&n=-Ff5k1r2A7v3Udje\&q=85\&s=645c2596780dde2177947cb47ae06a9a)

6. Create the token and copy the token that appears.

> [!NOTE]
>
> **Read** is required for Admina to retrieve the member list from Buildkite. **Write** is required on **Organizations** to delete accounts and on **Organization Invitations** to create accounts (invitations). **Read** is enough for **Teams**. **Write** does not include **Read**, so select both for each item where you select **Write**.
>
> See Buildkite's [Managing API access tokens (external site)](https://buildkite.com/docs/apis/managing-api-tokens). **Write** on **Organizations** removes members. **Write** on **Organization Invitations** creates and revokes invitations. **Read** on **Teams** lists teams.

## Setting up the integration

1. In the integration screen, search for **Buildkite**.

2. Enter the token you created in the previous step in **API Key**, then click **Connect**.

   ![The Buildkite integration screen where you enter the API key](https://mintcdn.com/moneyforwardi/-Ff5k1r2A7v3Udje/images/integrations/buildkite/admina-buildkite-setup.png?fit=max\&auto=format\&n=-Ff5k1r2A7v3Udje\&q=85\&s=1a882b1918f2a75f9d6d5cc1d3ac7191)

3. When the integration with Buildkite succeeds, registered user information appears in the account list. If it does not complete successfully, first try the steps in [Troubleshoot SaaS integration errors](https://support.i.moneyforward.com/en/it-management/saas-management/93nahw45is-trouble.md). If the issue persists, check [Information to provide](https://support.i.moneyforward.com/en/it-management/saas-management/93nahw45is-trouble.md#info-to-provide) and contact [Support](https://support.i.moneyforward.com/en/contact-support.md).


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