# Gandi

> Let your assistants check names, register domains, and manage DNS through Gandi. Registering and every DNS change wait for your Approve. Coming soon.

Status: Coming soon

Gandi is a domain registrar. Once you connect it, your assistants can check whether a name is free, list the domains you own, register a new one, and point a domain at your site through Gandi's DNS. Registering a domain and every DNS change stop at your Approve.

> [!SOON]
> The Gandi integration is Coming soon. This page describes how it will work. The integrations open at launch are GitHub, GitLab, and Bitbucket.

## Which assistants use it

| Assistant | Status | What it does with Gandi |
| --- | --- | --- |
| [Product owner](/docs/personas/product-owner) | Coming soon | Checks names and registers a domain |
| [Coder](/docs/personas/coder) | Available | Points a domain at your site, and registers one when your company has no Product owner |

When your company has a Product owner, it is the one that registers domains. Changing DNS records and nameservers is always the Coder's job.

## What assistants can do

| Ability | How it runs |
| --- | --- |
| Check whether a name is free | Reads on its own |
| List the domains in your Gandi account | Reads on its own |
| Register a domain | Always waits for your Approve |
| Set DNS records, such as pointing the domain at your site | Always waits for your Approve |
| Change the nameservers | Always waits for your Approve |

## Setup (when it opens)

1. In Gandi, open your account's security settings and create a personal access token for the organization that owns your domains.
2. Give it permission to see and register domains, change their technical settings, and manage their DNS. Leave everything else off.
3. Pick how long the token lasts and copy it.
4. Add prepaid funds in Gandi. Gandi takes what it charges for a registration from them.
5. Open [Integrations](https://stellarfirm.ai/app/integrations) in StellarFirm and pick Gandi.
6. Paste the token and press Connect.
7. Save your company's registrant contact in [Settings, Auto-approve](https://stellarfirm.ai/app/settings/auto-approve). It is who the domain is registered to.

## Permissions

- Checking names and listing your domains happen on their own.
- Registering a domain always waits for your Approve. The request shows what Gandi charges now and for each renewal year, and names the registrant contact that will be used. A name check only says whether a name is free.
- Setting DNS records or nameservers always waits for your Approve, and the request lists exactly what will change.
- No Auto-approve choice in Settings skips these. See [approvals](/docs/ceo/approvals).

## Good to know

- Gandi tokens expire. Once yours runs out, the assistants cannot reach Gandi until you create a new token and paste it in Integrations. A reminder in your calendar a few days before helps.
- Just before it registers, the assistant asks Gandi again. If the name was taken, or Gandi now charges more than you approved, nothing is registered and the assistant tells you why.
- To use other registrant details for one domain, reply with them before you approve. The assistant posts a new request with those details.
- To cut access, delete the token in Gandi.

## Prompts to try

```prompt title="Check a name"
Product owner, is [name].com free with Gandi? Do not register it yet.
```

```prompt title="Verify the domain for a service"
Coder, add the TXT record [value] to [name].com so [service] can verify we own it. Show me the record before I approve.
```

```prompt title="List our domains"
Coder, list the domains in our Gandi account with their nameservers and when each one comes up for renewal. Read only.
```

---

Source: https://stellarfirm.ai/docs/integrations/gandi