URL: /guides/organizations

---
title: Organisations and members
description: Create orgs, invite teammates, set roles.
---

Every action in DomainGenius runs in the context of an organisation. Domains, contacts, balance, and audit logs all live on the org, not the user.

## Solo accounts

Sign-up creates a default org for you. You can stay there forever — no penalty for never adding members. The org's slug and name become editable once you decide.

## Multi-tenant accounts

Add an org per client, project, or business unit. Each org has its own balance, billing, and domain list. Users move between orgs from the dashboard switcher.

## Create an org

```bash
curl -X POST "https://api.domaingenius.com.au/api/v1/orgs" \
  -H "Authorization: Bearer $DG_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme", "slug": "acme" }'
```

The slug must be unique across the platform. Check first with `GET /v1/orgs/check-slug?slug=acme`.

## Invite a member

```bash
curl -X POST "https://api.domaingenius.com.au/api/v1/orgs/$DG_ORG/members" \
  -H "Authorization: Bearer $DG_KEY" \
  -d '{ "email": "teammate@example.com", "role": "admin" }'
```

The invitee gets an email with a sign-in link. If they don't have a DomainGenius account, the same flow signs them up. Pending invites expire in 7 days.

## Roles

| Role | Can do |
| --- | --- |
| `owner` | Everything. There must be at least one owner. |
| `admin` | Everything except deleting the org or transferring ownership. |
| `member` | Read everything; trigger no state changes. Useful for read-only audit accounts. |

Change a role with `PATCH /v1/orgs/{org_oid}/members/{user_oid}`.

## Transfer ownership

Owner-only. From the dashboard: [`/dashboard/settings/danger-zone`](https://app.domaingenius.com.au/dashboard). The new owner gets an acceptance email; until they accept, both of you are owners.

## Delete an org

Owner-only, requires zero registered domains. Move or delete domains first. Deleting refunds any unspent balance to the original payment method.