[Intum](https://intum.fr/aide.md) / [Mail](https://intum.fr/aide/mail.md)

# [Foldery](https://intum.fr/aide/mail/foldery.md) | [API](#api)

## Czym są foldery?

Foldery pozwalają organizować [e-maile](e-maile) w logiczne grupy — np. "Reklamacje", "Zamówienia", "Faktury". Każdy e-mail może być przypisany do jednego folderu.

## Tworzenie folderu

1. Przejdź do **Mail** → **Foldery**
2. Kliknij **+** (Nowy folder)
3. Wypełnij:
   - **Nazwa** — unikalna nazwa folderu
   - **Opis** — opcjonalny opis przeznaczenia
   - **Osoba odpowiedzialna** — [użytkownik](../organizacja/uzytkownik), [grupa](../organizacja/grupa) lub [zespół](../organizacja/zespol)
   - **[Dział](../organizacja/dzial)** — opcjonalne przypisanie do działu
4. Zapisz

## Przypisywanie e-maili do folderu

E-maile można przypisywać do folderu:

- Ręcznie — z poziomu widoku e-maila
- Zbiorczo — zaznaczenie wielu e-maili i zmiana folderu
- Automatycznie — przez [filtry](filtry) (warunek + akcja "przenieś do folderu")

## Foldery a działy

Foldery mogą należeć do [działu](../organizacja/dzial). Nazwa folderu musi być unikalna w ramach działu i konta.

## Ukrywanie folderów

Folder można **ukryć** — nie pojawia się na liście do wyboru, ale przypisane e-maile pozostają bez zmian. Przydatne gdy folder jest nieaktualny.

## Ważne informacje

- Nazwa folderu musi być **unikalna** w ramach konta i działu
- Usunięcie folderu nie usuwa e-maili — zostają odpięte
- Folder ma **licznik e-maili** niearchiwizowanych
- E-mail może należeć do **jednego** folderu

---

## 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**

## Endpointy

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/mail/folders.json` | Lista folderów |
| GET | `/mail/folders/:id.json` | Pojedynczy folder |
| POST | `/mail/folders.json` | Utworzenie folderu |
| PATCH | `/mail/folders/:id.json` | Aktualizacja folderu |
| DELETE | `/mail/folders/:id.json` | Usunięcie folderu |

**Autoryzacja:** `Authorization: Bearer TOKEN` (uprawnienie: **mail**)

## Pola folderu

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `name` | string | tak | Nazwa folderu (unikalna) |
| `description` | string | nie | Opis folderu |
| `hidden` | boolean | nie | Czy ukryty |
| `responsible_id` | integer | nie | ID odpowiedzialnego |
| `team_id` | integer | nie | ID zespołu |
| `department_id` | integer | nie | ID działu |
| `group_id` | integer | nie | ID grupy |

## Tworzenie folderu

```
POST /mail/folders.json
Authorization: Bearer TOKEN
```

```json
{
  "folder": {
    "name": "Reklamacje",
    "description": "E-maile dotyczące reklamacji",
    "department_id": 3
  }
}
```

## Aktualizacja folderu

```
PATCH /mail/folders/:id.json
```

```json
{
  "folder": {
    "hidden": true
  }
}
```

## Błędy (422)

```json
{"name": ["nie może być puste"]}
```