---
title: "Create"
method: POST
path: "/backends/weighted"
tags: ["WeightedBackends"]
---

# Create

`POST /backends/weighted`

Create a new Weighted backend

## Headers

- `ngrok-version` integer, required

## Request body

- WeightedBackendCreate
  - `description` string — human-readable description of this backend. Optional
  - `metadata` string — arbitrary user-defined machine-readable data of this backend. Optional
  - `backends` object — the ids of the child backends to their weights [0-10000]

## Response `201`

Create a new Weighted backend

- WeightedBackend
  - `id` string — unique identifier for this Weighted backend
  - `uri` string — URI of the WeightedBackend API resource
  - `created_at` string — timestamp when the backend was created, RFC 3339 format
  - `description` string — human-readable description of this backend. Optional
  - `metadata` string — arbitrary user-defined machine-readable data of this backend. Optional
  - `backends` object — the ids of the child backends to their weights [0-10000]

---

[API](https://skmtc.net/ngrok/apis/ngrok-openapi.md) · [All operations](https://skmtc.net/ngrok/apis/ngrok-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ngrok/ngrok-openapi/versions/1994bbb04714/schema)