# Roles

An Instafuel user has **one** role, which determines what they see and what they can do. This page only covers the roles you handle or observe from the partner API.

## You

**Business introducer.** Not a user account but a **machine account**: your `ifp_*` key. It has no password, no dashboard, no session.

Its perimeter is your portfolio of client companies. See [Scope](/en/guides/perimetre).

## The accounts you create for your clients

Two roles, and only two, can be created through the partner API. Any other value returns `422 ROLE_NOT_ALLOWED`.

| API value | Business name | What it runs |
|---|---|---|
| `FLEET_ADMINISTRATOR` | fleet manager | vehicles, drivers, assignments, documents |
| `DAF` | finance director | top-up requests, caps, reports |

The split is deliberate: the finance director does not create vehicles, the fleet manager does not commit spending. The same dashboard screen can therefore be open to one and refused to the other.

<Callout type="note" title="These accounts are not yours">
  The account created belongs to the **client company**, not to your access perimeter. It signs in to the Instafuel dashboard with its own password, sees only its company, and has no access to the partner API.

  Conversely, your key does not let you act *as* one of those accounts.
</Callout>

### Activation

No account is created with a password. Each receives a **single-use activation link, valid for 72 h**, sent to its email address. That is why email is mandatory: without it, the account exists and can never sign in.

If the link expires, ask for it to be resent rather than recreating the account — a duplicate email returns `409 EMAIL_ALREADY_EXISTS`.

## Roles you observe but do not manage

**Driver** (`DRIVER`). Attached to a client company, they pay for fill-ups at stations from the Instafuel mobile app. You see them read-only — name, company, transactions — but you neither create nor modify them: that is your client's fleet manager's job.

A driver sees only their own transactions and their own cap.

## What does not exist on the partner side

The partner API exposes neither station accounts, nor fuel brand accounts, nor Instafuel administration accounts. Those roles exist, in other products and on other surfaces — they share no perimeter with yours and are not documented here.

## A vocabulary trap

In French, « partenaire » covers both a service-station operator, on the supply side, and a business introducer, on the demand side. These are two distinct notions with no common perimeter.

In this documentation, **partner** always means *business introducer*: you.