# Connect a MetaTrader account

> What you need from the trader, how to register, check and activate an MT4 or MT5 account, and how to follow it in your panel.

Canonical page: https://propmetaapi.com/help/connect-metatrader-account  
Topic: MetaTrader accounts & brokers  
Last updated: 2026-10-28

## 1. What you need

- **Platform** — MT4 or MT5.
- **Broker** — a broker listed under **API → Brokers** (see [Brokers and broker requests](https://propmetaapi.com/help/brokers-and-requests)).
- **Server** — the exact server name the trader's terminal shows, for example `Exness-MT5Trial12`.
- **Login** — the account number.
- **Password** — the **master** (trading) password to trade, or the **investor** (read-only) password to only read.

Passwords are stored encrypted and are only used to log your accounts in.

## 2. Register, check, activate

Accounts are managed through the API with a key that has the Manage permission:

- `POST /v1/accounts` registers the account. It starts in **STANDBY** and uses no active slot.
- `POST /v1/accounts/{id}/check` logs in once and confirms the password works — do this before you hand the account to a user.
- `POST /v1/accounts/{id}/activate` starts the permanent connection (**ACTIVE**).
- `POST /v1/accounts/{id}/deactivate` returns it to STANDBY and frees the active slot; `DELETE /v1/accounts/{id}` removes it.

The [Accounts & brokers](https://propmetaapi.com/docs/accounts) page of the docs has every field and example.

> Registering the same server and login again doesn't create a duplicate: it updates the stored passwords.

## 3. Follow your accounts in the panel

**API → MT accounts** lists every account with its **State** (Active, Standby), **Connection** (for example Connecting, Connected, Disconnected, Login rejected) and **Authorization** of the master and investor passwords. Click **Refresh** to update. The page is read-only — changes are made through the API.

## 4. Good practice

- Test on demo accounts first.
- Keep only accounts that need live data or fast trading ACTIVE; the rest can stay in STANDBY.
- Subscribe to `ACCOUNT_STATE_CHANGED` and `AUTH_REJECTED` events so you know when a trader changes their password.
- Give every account an `externalRef` (your own user or challenge ID) so you can find it later.

## For developers

- [Accounts & brokers](https://propmetaapi.com/docs/accounts)

## Related guides

- [Account connection problems](https://propmetaapi.com/help/account-connection-problems): Login rejected, disconnected, disabled by the broker, not connected or trading refused — what each state means and how to fix it.
- [Brokers and broker requests](https://propmetaapi.com/help/brokers-and-requests): See which brokers you can use right away, and ask us to add a broker that is missing.
- [How PropMetaAPI works](https://propmetaapi.com/help/how-it-works): The basics in plain words: what we run for each account, active and standby accounts, and how your software gets live data.
