> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.laposta.org/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.laposta.org/_mcp/server.

# Labels op relaties gebruiken

> Geef je relaties eigen labels om op te filteren, campagnes naar een selectie te sturen en te gebruiken in segmenten en automations.

Een label is een kenmerk dat je zelf bedenkt en aan een relatie hangt, zoals ‘Klant’, ‘Offerte’ of ‘Beurs’. Eén relatie kan meerdere labels hebben en elke lijst heeft zijn eigen labels.

Je gebruikt ze om te filteren in het relatieoverzicht, de ontvangers van een campagne te kiezen, als voorwaarde in een segment en als startmoment of bouwstuk in een automation.

## Labels beheren

Ga naar Relaties, klik op je lijst en klik bovenaan op ‘Labels’. Je ziet alle labels van die lijst met het aantal actieve relaties per label.

![Het scherm Labels met een invulveld voor een nieuw label en een tabel met drie labels, de kleurenstrip en het aantal actieve relaties](/_fern-files/_img/dcc53683034738c648b15760207de995c7ec6e5194daa457a7c8a9ece0b9cda9.webp)

In dit scherm beheer je de labels van de lijst:

* Aanmaken: typ een naam in het veld en klik op ‘Toevoegen’. Je hoeft labels overigens niet vooraf aan te maken. Ze worden ook vanzelf aangemaakt zodra je een nieuwe naam bij een relatie invult of mee-importeert.
* Kleur geven: beweeg met de muis over een label en klik een kleur aan in de strip die verschijnt. Het label krijgt deze kleur overal waar het wordt getoond.
* Naam wijzigen: dubbelklik op het label of klik op het pennetje ernaast, pas de naam aan en klik op ‘Opslaan’. Segmenten en campagnes die het label gebruiken blijven gewoon werken.
* Samenvoegen: geef je een label de naam van een bestaand label, dan stelt Laposta voor om ze samen te voegen. Na je bevestiging krijgen alle relaties het bestaande label en worden segmenten en campagnes automatisch bijgewerkt. Automations die het oude label gebruiken moet je nog wel zelf aanpassen. Het bevestigingsscherm laat zien welke dat zijn.
* Verwijderen: klik op het prullenbak-icoon. Wordt het label nog ergens gebruikt, dan waarschuwt Laposta eerst en zie je precies waar.

> **Warning**
>
> Maak je na het verwijderen een label met exact dezelfde naam, dan wordt het oude label hersteld, inclusief de relaties en segmenten die het gebruikten. Wil je echt opnieuw beginnen, kies dan een andere naam.

## Labels toevoegen aan relaties

#### Eén relatie

Open de details van de relatie en kies of typ een label in het veld ‘Labels’. Typ je een naam die nog niet bestaat, dan maak je daarmee meteen een nieuw label aan.

#### Meerdere relaties tegelijk

Ga naar Relaties → Bekijken, vink de relaties aan en klik op ‘Wijzig labels’. Kies of typ in het venster een of meer labels en geef aan of je ze aan de selectie wilt toevoegen of eruit wilt verwijderen.

#### Bij het importeren

Koppel tijdens [het importeren](/hoe-importeer-ik-een-groot-relatiebestand) een kolom uit je bestand aan ‘Labels’. Heet die kolom `labels` of `tags`, dan staat de koppeling al klaar. Meerdere labels in één cel scheid je met een komma of een verticaal streepje. Waarden die nog niet bestaan worden nieuwe labels.

#### Automatisch

Een automation kan labels toevoegen en verwijderen met [het bouwstuk Labels](/automation-bouwstuk-labels). Dat is handig als je iemand een label wilt geven na een bepaalde actie, bijvoorbeeld iedereen die op een link heeft geklikt.

## Filteren en exporteren

Onder Relaties → Bekijken staan de labels achter elke relatie. Klik op een label om alleen de relaties met dat label te zien, of kies rechtsboven een label uit de lijst.

Exporteer je daarna je lijst, dan neemt Laposta het actieve filter over en krijg je alleen de gefilterde relaties. Het exportbestand bevat een kolom ‘Labels’ met de labels per relatie.

## Een campagne sturen naar relaties met een label

Bij het maken van een campagne vink je in stap 2 (‘Selecteer ontvangers’) een lijst aan. Heeft die lijst labels, dan kun je in plaats daarvan een of meer labels kiezen.

![Stap Selecteer ontvangers met onder de lijstnaam een uitgeklapt blok labels waarin twee labels zijn gekozen en het aantal ontvangers staat](/_fern-files/_img/35edfe203c4ab550ad51680d077b14c422c378cb53dae7d59b594e00caf0385f.webp)

De campagne wordt dan verstuurd naar iedereen met minimaal één van de gekozen labels. Het aantal staat er direct bij. Kies je daarnaast segmenten of andere lijsten, dan ontdubbelt Laposta automatisch, zodat niemand de campagne twee keer krijgt.

## Labels gebruiken in een segment

Wil je een label combineren met een andere voorwaarde, zoals het label ‘Klant’ én woonplaats Amsterdam, maak dan een [segment](/hoe-segmenteer-ik-op-basis-van-relatiegegevens). Kies als voorwaarde het veld ‘Labels’ en selecteer een of meer labels.

## Labels gebruiken in een automation

Met het startmoment [Label toevoegen](/startmoment-label-toevoegen) begint een automation zodra een relatie een label krijgt. Met [het bouwstuk Labels](/automation-bouwstuk-labels) kun je halverwege de automation een label toevoegen of verwijderen. Daarnaast kun je labels net als elk ander veld gebruiken in de bouwstukken [Als/dan](/als-dan) en [Wacht tot…](/wacht-tot).

## Labels uitlezen en meegeven via de API

Je kunt labels ook via [de API](/api) opvragen en toekennen. Zodra een lijst minstens één label heeft, verschijnen ze bij de relatie als een veld met de naam `labels`. Vraag je de velden van een lijst op, dan staan alle labels van die lijst erbij als de mogelijke waarden van dat veld.

Bij het toevoegen of wijzigen van een relatie geef je labels mee als een reeks:

**`Twee labels aan een relatie hangen`**

```bash title="Twee labels aan een relatie hangen"
curl https://api.laposta.nl/v2/member/naam@voorbeeld.nl \
  -u JOUW_API_SLEUTEL: \
  -d list_id=JOUW_LIJST_ID \
  -d "custom_fields[labels][]=Klant" \
  -d "custom_fields[labels][]=Beurs"
```

De vierkante haken zijn verplicht. Laat je ze weg, dan wordt het label niet opgeslagen, ook al geeft de API geen foutmelding.

> **Warning**
>
> Via de API kun je alleen labels meegeven die al bestaan. Stuur je een naam mee die de lijst niet heeft, dan krijg je foutcode 203 met de melding dat de optie onbekend is. Maak nieuwe labels dus eerst aan in je account of via een import.

## Gerelateerde artikelen

#### [Wat zijn actieve, uitgeschreven en opgeschoonde relaties?](/waar-vind-ik-een-overzicht-van-actieve-uitgeschreven-en-opgeschoonde-relaties)

Op de pagina Relaties → Bekijken zie je per tabblad wie je nieuwsbrieven ontvangt, wie…

#### [Een segment maken op basis van relatiegegevens](/hoe-segmenteer-ik-op-basis-van-relatiegegevens)

Deel je lijst op met selectieregels op basis van de gegevens van je relaties.

#### [Labels toevoegen of weghalen in een automation](/automation-bouwstuk-labels)

Ken tijdens een automation automatisch een of meer labels toe aan een relatie, of…

#### [Een bestand met relaties importeren uit Excel of csv](/hoe-importeer-ik-een-groot-relatiebestand)

Voeg in één keer nieuwe relaties toe aan je lijst of werk de gegevens van je bestaande…