> 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.

# Relatie wijzigen

POST https://api.laposta.nl/v2/member/{member_id}
Content-Type: application/x-www-form-urlencoded

Wijzigt een relatie of meldt hem af met `state`. Je stuurt alleen mee wat anders moet worden. Let op bij een meerkeuzeveld: een lege array maakt het veld niet leeg, de bestaande keuzes blijven dan staan.You only have to include the fields that need to be modified in the request. Fields that are not named will keep their current value. As soon as a field is mentioned it does get checked, and thus can cause an error message. This error message displays a code with a message. See above under 'Error messages' what the codes stand for.Ändert einen Abonnenten oder meldet ihn mit `state` ab. Du schickst nur mit, was anders werden soll. Achtung bei einem Mehrfachauswahlfeld: ein leeres Array leert das Feld nicht, die bestehenden Auswahlen bleiben dann stehen.Modifica un contacto o lo da de baja con `state`. Solo envías lo que debe cambiar. Ten cuidado con un campo de selección múltiple: un array vacío no vacía el campo, las opciones existentes se mantienen.

Reference: https://docs.laposta.org/relaties/relatie-wijzigen

## Authentication

- `Authorization` header (basic auth, required) — Vul je API-sleutel in bij `api_key` en laat `leave_empty` leeg. De API gebruikt basic auth, waarbij je sleutel de plaats van de gebruikersnaam inneemt. In curl schrijf je dat als `-u JOUW_SLEUTEL:`, met een dubbele punt en niets erachter.Enter your API key at `api_key` and leave `leave_empty` empty. The API uses basic auth, with your key in place of the username. In curl that reads `-u YOUR_KEY:`, with a colon and nothing after it.Trage deinen API-Schlüssel bei `api_key` ein und lass `leave_empty` leer. Die API nutzt Basic Auth, wobei dein Schlüssel an die Stelle des Benutzernamens tritt. In curl schreibst du das als `-u DEIN_SCHLUESSEL:`, mit einem Doppelpunkt und nichts dahinter.Introduce tu clave API en `api_key` y deja `leave_empty` vacío. La API usa basic auth, con tu clave en lugar del nombre de usuario. En curl se escribe como `-u TU_CLAVE:`, con dos puntos y nada después.

## Request

### Path parameters

- `member_id` (string, required)

### Body (application/x-www-form-urlencoded)

This endpoint expects an object.

- `list_id` (string, required) — Het id van de lijst. Dat vind je in het antwoord van [Alle lijsten opvragen](/lijsten/alle-lijsten-opvragen), en in de applicatie in de URL van de lijst.The id of the list. You find it in the response of [Get all lists](/lijsten/alle-lijsten-opvragen), and in the application in the URL of the list.Die ID der Liste. Du findest sie in der Antwort von [Alle Listen abrufen](/lijsten/alle-lijsten-opvragen) und in der Anwendung in der URL der Liste.El id de la lista. Lo encuentras en la respuesta de [Obtener todas las listas](/lijsten/alle-lijsten-opvragen) y en la aplicación, en la URL de la lista.
- `email` (string, optional) — Het e-mailadres van de te wijzigen relatie.The email address of the subscriber that must be modifiedDie E-Mail-Adresse des zu ändernden Abonnenten.La dirección de correo electrónico del contacto que se va a modificar.
- `state` (enum, optional) — De nieuwe status van de relatie: active of unsubscribed.The new status of the subscriber: active or unsubscribedDer neue Status des Abonnenten: active oder unsubscribed.El nuevo estado del contacto: active o unsubscribed.
  - Allowed values: `active`, `deleted`
- `custom_fields` (MemberMemberIdPostRequestBodyContentApplicationXWwwFormUrlencodedSchemaCustomFields, optional) — De waardes van de extra aangemaakte velden. Labels geef je mee als reeks, met vierkante haken: custom_fields[labels][]=Klant. Alleen labels die de lijst al heeft worden geaccepteerd; nieuwe labels maak je aan in de applicatie of bij een import.The values of the extra created fields. You pass labels as an array, with square brackets: custom_fields[labels][]=Customer. Only labels the list already has are accepted; you create new labels in the application or during an import.Die Werte der zusätzlich angelegten Felder. Labels werden als Array übergeben, mit eckigen Klammern: custom_fields[labels][]=Kunde. Akzeptiert werden nur Labels, die die Liste bereits hat; neue Labels legt man in der Anwendung oder bei einem Import an.Los valores de los campos adicionales creados. Las etiquetas las pasas como array, con corchetes: custom_fields[labels][]=Cliente. Solo se aceptan etiquetas que la lista ya tiene; las etiquetas nuevas las creas en la aplicación o en una importación.

## Response

### 200

De aanvraag is gelukt.The request succeeded.Die Anfrage war erfolgreich.La solicitud se ha realizado correctamente.

- `member` (Member, optional) — Het member-objectThe member objectDas member-ObjektEl objeto member

## Errors

### 400 Bad Request Error

De aanvraag klopt niet. Het antwoord bevat een `type`, een `message` en meestal een `code` en de `parameter` die de fout veroorzaakte. Een object dat niet bestaat valt ook hieronder, met code 203.The request is not valid. The response contains a `type`, a `message` and usually a `code` plus the `parameter` that caused it. An object that does not exist also falls under this, with code 203.Die Anfrage stimmt nicht. Die Antwort enthält einen `type`, eine `message` und meistens einen `code` und den `parameter`, der den Fehler verursacht hat. Ein Objekt, das nicht existiert, fällt ebenfalls hierunter, mit Code 203.La solicitud no es correcta. La respuesta contiene un `type`, un `message` y normalmente un `code` y el `parameter` que ha causado el error. Un objeto que no existe también entra aquí, con el código 203.

- `error` (ErrorError, optional)

### 401 Unauthorized Error

Er is geen geldige API-sleutel meegestuurd, of dit endpoint staat niet aan voor dit account.No valid API key was provided, or this endpoint is not enabled for this account.Es wurde kein gültiger API-Schlüssel mitgeschickt, oder dieser Endpunkt ist für dieses Konto nicht aktiv.No se ha enviado una clave API válida, o este endpoint no está activado para esta cuenta.

- `error` (ErrorError, optional)

### 429 Too Many Requests Error

Je hebt te veel aanvragen in een minuut gedaan. De header `Retry-After` vertelt na hoeveel seconden het weer mag.Too many requests in one minute. The `Retry-After` header tells you how many seconds to wait.Du hast zu viele Anfragen in einer Minute gestellt. Der Header `Retry-After` sagt, nach wie vielen Sekunden es wieder erlaubt ist.Has hecho demasiadas solicitudes en un minuto. La cabecera `Retry-After` indica después de cuántos segundos puedes volver a intentarlo.

- `error` (ErrorError, optional)

## Types

### MemberMemberIdPostRequestBodyContentApplicationXWwwFormUrlencodedSchemaCustomFields

De waardes van de extra aangemaakte velden. Labels geef je mee als reeks, met vierkante haken: custom_fields[labels][]=Klant. Alleen labels die de lijst al heeft worden geaccepteerd; nieuwe labels maak je aan in de applicatie of bij een import.The values of the extra created fields. You pass labels as an array, with square brackets: custom_fields[labels][]=Customer. Only labels the list already has are accepted; you create new labels in the application or during an import.Die Werte der zusätzlich angelegten Felder. Labels werden als Array übergeben, mit eckigen Klammern: custom_fields[labels][]=Kunde. Akzeptiert werden nur Labels, die die Liste bereits hat; neue Labels legt man in der Anwendung oder bei einem Import an.Los valores de los campos adicionales creados. Las etiquetas las pasas como array, con corchetes: custom_fields[labels][]=Cliente. Solo se aceptan etiquetas que la lista ya tiene; las etiquetas nuevas las creas en la aplicación o en una importación.

### Member

Het member-objectThe member objectDas member-ObjektEl objeto member

- `member_id` (string, optional) — Het id van dit member object.The ID of this member objectDie ID dieses member-Objekts.El ID de este objeto member.
- `list_id` (string, optional) — Het id van de bijbehorende lijst.The ID of the related listDie ID der zugehörigen Liste.El ID de la lista correspondiente.
- `email` (string, optional) — Het e-mail adres.The email addressDie E-Mail-Adresse.La dirección de correo electrónico.
- `state` (enum, optional) — De huidige status van deze relatie: active, unsubscribed, unconfirmed of cleaned.The current status of this subscriber: active, unsubscribed, unconfirmed or cleanedDer aktuelle Status dieses Abonnenten: active, unsubscribed, unconfirmed oder cleaned.El estado actual de este contacto: active, unsubscribed, unconfirmed o cleaned.
  - Allowed values: `active`, `deleted`
- `timezone` (string, optional) — De tijdzone van het account voor datum- en tijdvelden.The account timezone used for datetime fieldsDie Zeitzone des Kontos für Datums- und Zeitfelder.La zona horaria de la cuenta para los campos de fecha y hora.
- `signup_date` (string, optional) — Moment van aanmelding.Date and time of subscriptionZeitpunkt der Anmeldung.Momento del registro.
- `signup_date_iso` (string, optional, nullable) — Moment van aanmelding in ISO-formaat.Date and time of subscription in ISO formatZeitpunkt der Anmeldung im ISO-Format.Momento del registro en formato ISO.
- `modified` (string, optional, nullable) — Moment van laatste wijziging.Date and time of last modification madeZeitpunkt der letzten Änderung.Momento de la última modificación.
- `modified_iso` (string, optional, nullable) — Moment van laatste wijziging in ISO-formaat.Date and time of last modification in ISO formatZeitpunkt der letzten Änderung im ISO-Format.Momento de la última modificación en formato ISO.
- `confirm_date` (string, optional, nullable) — Moment van bevestiging.Date and time of confirmationZeitpunkt der Bestätigung.Momento de la confirmación.
- `confirm_date_iso` (string, optional, nullable) — Moment van bevestiging in ISO-formaat.Date and time of confirmation in ISO formatZeitpunkt der Bestätigung im ISO-Format.Momento de la confirmación en formato ISO.
- `ip` (string, optional) — Het IP-adres waarvandaan de relatie zich heeft aangemeld.IP from which the subscriber is registeredDie IP-Adresse, von der aus sich der Abonnent angemeldet hat.La dirección IP desde la que se ha registrado el contacto.
- `source_url` (string, optional) — De pagina waarvandaan de relatie zich heeft aangemeld.URL from which the subscriber is registeredDie Seite, von der aus sich der Abonnent angemeldet hat.La página desde la que se ha registrado el contacto.
- `custom_fields` (MemberCustomFields, optional) — De waarden van de eigen velden van de lijst, met de `custom_name` van elk veld als sleutel. Heeft de lijst labels, dan staat daar `labels` bij, met de labels van deze relatie als array.An array with the value of all additional fields of the corresponding list. If there are fields where several options can be selected, these options are listed in an array. If the list has labels, `labels` is included as well, with the labels of that subscriber as an array.Die Werte der eigenen Felder der Liste, mit dem `custom_name` jedes Feldes als Schlüssel. Hat die Liste Labels, dann steht dort auch `labels`, mit den Labels dieses Abonnenten als Array.Los valores de los campos adicionales de la lista, con el `custom_name` de cada campo como clave. Si la lista tiene etiquetas, ahí aparece también `labels`, con las etiquetas de este contacto como array.

### ErrorError

- `type` (enum, required)
  - Allowed values: `invalid_request`, `invalid_input`, `internal`
- `message` (string, required)
- `code` (integer, optional)
- `parameter` (string, optional)

### MemberCustomFields

De waarden van de eigen velden van de lijst, met de `custom_name` van elk veld als sleutel. Heeft de lijst labels, dan staat daar `labels` bij, met de labels van deze relatie als array.An array with the value of all additional fields of the corresponding list. If there are fields where several options can be selected, these options are listed in an array. If the list has labels, `labels` is included as well, with the labels of that subscriber as an array.Die Werte der eigenen Felder der Liste, mit dem `custom_name` jedes Feldes als Schlüssel. Hat die Liste Labels, dann steht dort auch `labels`, mit den Labels dieses Abonnenten als Array.Los valores de los campos adicionales de la lista, con el `custom_name` de cada campo como clave. Si la lista tiene etiquetas, ahí aparece también `labels`, con las etiquetas de este contacto como array.

## Examples

**Request**

```json
{
  "list_id": "BaImMu3JZA"
}
```

**Response**

```json
{
  "member": {
    "member_id": "ZKfjhLJHfl",
    "list_id": "BaImMu3JZA",
    "email": "relatie@example.net",
    "state": "active",
    "timezone": "Europe/Amsterdam",
    "signup_date": "string",
    "signup_date_iso": "string",
    "modified": "string",
    "modified_iso": "string",
    "confirm_date": "string",
    "confirm_date_iso": "string",
    "ip": "string",
    "source_url": "string",
    "custom_fields": {}
  }
}
```

**SDK Code**

```python
import requests

url = "https://api.laposta.nl/v2/member/member_id"

payload = ""
headers = {
    "Content-Type": "application/x-www-form-urlencoded"
}

response = requests.post(url, data=payload, headers=headers, auth=("<api_key>", "<leave_empty>"))

print(response.json())
```

```javascript
const url = 'https://api.laposta.nl/v2/member/member_id';
const credentials = btoa("<api_key>:<leave_empty>");

const options = {
  method: 'POST',
  headers: {
    Authorization: `Basic ${credentials}`,
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: new URLSearchParams('')
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.laposta.nl/v2/member/member_id"

	req, _ := http.NewRequest("POST", url, nil)

	req.SetBasicAuth("<api_key>", "<leave_empty>")
	req.Header.Add("Content-Type", "application/x-www-form-urlencoded")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.laposta.nl/v2/member/member_id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request.basic_auth("<api_key>", "<leave_empty>")
request["Content-Type"] = 'application/x-www-form-urlencoded'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.laposta.nl/v2/member/member_id")
  .basicAuth("<api_key>", "<leave_empty>")
  .header("Content-Type", "application/x-www-form-urlencoded")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.laposta.nl/v2/member/member_id', [
  'form_params' => null,
  'headers' => [
    'Content-Type' => 'application/x-www-form-urlencoded',
  ],
    'auth' => ['<api_key>', '<leave_empty>'],
]);

echo $response->getBody();
```

```csharp
using RestSharp;
using RestSharp.Authenticators;

var client = new RestClient("https://api.laposta.nl/v2/member/member_id");
client.Authenticator = new HttpBasicAuthenticator("<api_key>", "<leave_empty>");
var request = new RestRequest(Method.POST);

request.AddHeader("Content-Type", "application/x-www-form-urlencoded");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let credentials = Data("<api_key>:<leave_empty>".utf8).base64EncodedString()

let headers = [
  "Authorization": "Basic \(credentials)",
  "Content-Type": "application/x-www-form-urlencoded"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.laposta.nl/v2/member/member_id")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```