---
title: "Adds a new joiner"
method: POST
path: "/node/commissioner/joiner"
tags: ["node"]
---

# Adds a new joiner

`POST /node/commissioner/joiner`

## Request body

- JoinerData
  - `pskd` string — Joining device's pre-shared key
  - `joinerId` string — A string of the EUI-64, Discerner, or "*", mutually exclusive with `eui` and `discerner`.
  - `eui` string — A string of the EUI-64, mutually exclusive with `joinerId` and `discerner`.
  - `discerner` string — A discerner in the form of the discerner hex value (optionally with leading 0x) and bit length separated by a '/'. Field is mutually exclusive with `joinerId` and `eui`.
  - `timeout` integer — Joiner expiration time in milliseconds on response and seconds on request

## Response `200`

Successfully added joiner.

## Other responses

- `400` — Invalid request body.
- `409` — Adding joiner rejected because commissioner is not active.
- `507` — Number of joiners the commissioner supports is full and the new one cannot be added.

---

[API](https://skmtc.net/openthread/apis/swagger-openthread-rest-api.md) · [All operations](https://skmtc.net/openthread/apis/swagger-openthread-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openthread/swagger-openthread-rest-api/revisions/7996e8479177/schema)