---
title: "Issue a configuration for an STUN/TURN server."
method: POST
path: "/networkTraversal/:issueRelayConfiguration"
tags: ["Turn"]
---

# Issue a configuration for an STUN/TURN server.

`POST /networkTraversal/:issueRelayConfiguration`

## Query parameters

- `api-version` string, required

## Request body

- CommunicationRelayConfigurationRequest — Request for a CommunicationRelayConfiguration.
  - `id` string — An identity to be associated with telemetry for data relayed using the returned credentials. Must be an existing ACS user identity. If not provided, the telemetry will not contain an associated identity value.
  - `routeType` 'any' | 'nearest' — The routing methodology to where the ICE server will be located from the client. "any" will have higher reliability while "nearest" will have lower latency. It is recommended to default to use the "any" routing method unless there are specific scenarios which minimizing latency is critical.
  - `ttl` integer — The credential Time-To-Live (TTL), in seconds. The default value will be used if given value exceeds it.

## Response `200`

Success

- CommunicationRelayConfiguration — A relay configuration containing the STUN/TURN URLs and credentials.
  - `expiresOn` string, date-time, required — The date for which the username and credentials are not longer valid. Will be 48 hours from request time.
  - `iceServers` CommunicationIceServer[], required — An array representing the credentials and the STUN/TURN server URLs for use in ICE negotiations.
    - `urls` string[], required — List of STUN/TURN server URLs.
    - `username` string, required — User account name which uniquely identifies the credentials.
    - `credential` string, required — Credential for the server.
    - `routeType` 'any' | 'nearest', required — The routing methodology to where the ICE server will be located from the client. "any" will have higher reliability while "nearest" will have lower latency. It is recommended to default to use the "any" routing method unless there are specific scenarios which minimizing latency is critical.

## Other responses

- `default` — Error

## Changes

- **2026-07-13** `64f0e5e59534` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/communication-networktraversal/changes/networkTraversal/:issueRelayConfiguration/post.md)

---

[API](https://skmtc.dev/azure/apis/communication-networktraversal.md) · [All operations](https://skmtc.dev/azure/apis/communication-networktraversal/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/communication-networktraversal/revisions/64f0e5e59534/schema)