[Intum](https://intum.pl/pomoc.md) / [Mail](https://intum.pl/pomoc/mail.md)

# [Foldery](https://intum.pl/pomoc/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
<h3>Film - jak utworzyć folder</h3>
<p><iframe src="https://s3.eu-west-1.amazonaws.com/attachments.intum.net/public-files/2/65980b96d5b8c59dccf8ea428b0ef5fa841018a8?v=https%3A%2F%2Fs3.eu-west-1.amazonaws.com%2Fattachments.intum.net%2Fpublic-files%2F2%2F26eb7ce58b28faff2dc842c58f9e8f9f84731b8f&amp;poster=https%3A%2F%2Fs3.eu-west-1.amazonaws.com%2Fattachments.intum.net%2Fpublic-files%2F2%2F7d262f20510a37d8b2791fd3aaf1891ffa3b0ef4&amp;start=0" style="width:100%;max-width:720px;aspect-ratio:16/9;height:auto;display:block;margin:0 auto;border:0" loading="lazy" frameborder="0" allowfullscreen></iframe></p>

---

## 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"]}
```

---

## Powiązane

- [Foldery w module Mail – jak organizować korespondencję?](https://intum.pl/pomoc/mail/foldery-w-module-mail.md)