---
title: "Create elements in multiple lists"
method: POST
path: "/xlist/elements"
tags: ["multilist"]
---

# Create elements in multiple lists

`POST /xlist/elements`

Create elements in lists

Required security scopes:
  * `api:update`

## Query parameters

- `errors_only` boolean
- `results` boolean

## Request body

- ListPayloadQL
  - `all_in_sets` string[] — Include all lists in these sets
  - `lists` string[] — Include lists that match exact list names
  - `match_metadata` object — Include lists that match all values in metadata
  - `payload` Element[] — Payloads for create/update functions. Will be ignored on deletes.
    - `id` integer, required — ID of element
    - `payload` object — Custom payload. Stored untouched. On updates null means do not update. `{}` is the empty value.
    - `score` integer, required — Score of the element. Higher score gives higher placement.
    - `tie_breaker` integer — Tie breaker, used if score matches for consistent sorting. Higher value = higher placement if score is equal.

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/vivino/apis/the-rankdb-api.md) · [All operations](https://skmtc.net/vivino/apis/the-rankdb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vivino/the-rankdb-api/revisions/7a45b5309a11/schema)