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

# Gandi

> Connect Gandi to Triggr with a Gandi personal access token, so workflows can look up, check and renew domain names.

Triggr lists your Gandi domains, checks availability, reads their details and contacts, and renews them.

## Set up Gandi

**1. Create a token**

In Gandi, click Organizations, open the organisation that holds your domains, go to the Sharing tab and click Create a token.

**2. Set its expiry and permissions**

Choose Expires in, and under Token resources choose The whole organization or Restrict to selected products. Turn on See and renew domain names.

**3. Copy the token**

Click Create, then Copy. Gandi shows the token only once, and an expired token can't be reused, so note its expiry date.

See Gandi's [Manage API accesses with a Personal Access Token](https://docs.gandi.net/en/managing_an_organization/organizations/personal_access_token.html).

## Connect it in Triggr

**1. Open the integration**

Go to **Integrations > Gandi** and click **Configure** on the Base Configuration card.

![The Base Configuration card with Status Not Configured, Admin Consent Not Required and a Configure button.](https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/integrations-common/base-configuration.png?fit=max\&auto=format\&n=nyuVXZ1rouDTTEvu\&q=85\&s=bb81acb082055015f91beda7b4876f35)

**2. Paste the token**

Paste the personal access token into apiKey, then click **Save Configuration**.

![The Gandi configuration window with an apiKey field described as Gandi API Key, an Allow insecure TLS switch under Advanced, and a Save Configuration button.](https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/gandi/configure.png?fit=max\&auto=format\&n=nyuVXZ1rouDTTEvu\&q=85\&s=6add8cee3c607664defb503d2e28c6fa)

To renew a domain, run Get Renewal Information to check `prohibited` and the accepted `durations`, then Renew Domain with `durationInYears` from that range. Gandi charges renewals to your prepaid account.

## Troubleshooting

> [accordion] Every action fails with 401 or 403
>
> Check the token is complete, hasn't expired, has See and renew domain names, and is a personal access token, not one of Gandi's older API keys.

> [accordion] A domain is missing or returns 403
>
> The token covers only its own organisation and, if restricted, its selected products. Create a token that includes the domain.

> [accordion] A renewal doesn't go through
>
> Check your prepaid account has enough credit, and that Get Renewal Information allows the duration.

> [accordion] Rotate the token
>
> Create a new token, click Edit on the Base Configuration card to paste it, then delete the old one on the Sharing tab.


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