[Intum](https://intum.fr/aide.md) / [Konto](https://intum.fr/aide/konto.md)

# [Ustawienia konta](https://intum.fr/aide/konto/ustawienia-konta.md) | [API](#api)

## Ustawienia konta

Ustawienia konta pozwalają skonfigurować podstawowe informacje, wygląd i zachowanie Twojego konta w systemie.

## Podstawowe informacje

- **Nazwa konta** — wyświetlana w nagłówku i na stronach konta
- **Opis** — krótki opis konta (opcjonalny)
- **Prefix (subdomena)** — adres konta, np. `mojafirma.intum.pl` — generowany automatycznie lub ustawiany ręcznie
- **Domena główna** — wybór głównej domeny konta z listy skonfigurowanych domen

## Lokalizacja

- **Strefa czasowa** — domyślnie Warszawa, wpływa na wyświetlanie dat i godzin w całym systemie
- **Język** — domyślny język interfejsu konta (polski, angielski, francuski, czeski, słowacki, niemiecki, hiszpański, ukraiński)

## Bezpieczeństwo

- **Wymuszone 2FA** — wymuszenie weryfikacji dwuetapowej dla wszystkich użytkowników konta. Po włączeniu użytkownicy mają miesięczny okres przejściowy na skonfigurowanie 2FA — po tym czasie logowanie bez 2FA zostanie zablokowane

## Dodatkowe pola

Konto pozwala definiować własne pola dla różnych obiektów w systemie (klienci CRM, kontakty, transakcje, zadania, projekty). Każde pole ma:

- Typ (tekst, liczba, data, boolean, lista wyboru)
- Etykietę
- Wartość domyślną
- Flagę wymagalności
- Opcję wyświetlania na liście

Dodatkowe pola konfiguruje się w ustawieniach odpowiednich modułów (CRM, Organize).

---

## API

### Ogólne API

# Intum API

Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy.

## Host

Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta)

## Autoryzacja

Wszystkie requesty API wymagają `api_token`:
- header: `Authorization: Bearer TOKEN`

Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API**

## API — Ustawienia konta

### Pobranie ustawień

```
GET /account/settings.json
```

### Pobranie danych konta

```
GET /account/show.json
```

### Aktualizacja konta

```
PATCH /account/update.json
```

**Parametry:**

- `account[name]` — nazwa konta
- `account[description]` — opis
- `account[prefix]` — subdomena
- `account[domain]` — domena główna
- `account[timezone]` — strefa czasowa
- `account[locale]` — język (pl, en, fr, cs, sk, de, es, uk)
- `account[company_fields]` — dane firmowe (JSON)
- `account[fields]` — dodatkowe pola (JSON)

### Ustawianie wartości pól (set_field)

```
POST /account/set_field.json
```

**Parametry:**

- `key` — klucz pola (np. `account.settings.modules`)
- `value` — wartość
- `target` — cel: `account`, `user_setting` lub `mail_setting`
- `field` — typ pola: `fields` lub `config`
- `action_type` — `add` lub `remove` (dla tablic)

### Wymuszenie 2FA

```
POST /account/force_2fa.json
```

**Parametry:** `value` (boolean)