---
title: "Follow a list of users"
method: POST
path: "/users/{user_id}/following"
tags: ["Users\\Follows"]
---

# Follow a list of users

`POST /users/{user_id}/following`

## Path parameters

- `user_id` number, required

## Request body

- object
  - `users` string[], required — An array of user URIs for the list of users to follow.

## Response `204`

The users were followed.

## Other responses

- `400` — There are five ways that this status code can be encountered: * The request body is empty. Returns a unique error code of `2205`. * The `users` array is invalid. Returns a unique error code of `2205`. * The list of users does not contain URIs. Returns a unique error code of `2205`. * A user in the list does not exist. Returns a unique error code of `2900`. * The list contains more than 100 users. Returns a unique error code of `2901`.
- `401` — The user access token is invalid. Returns a unique error code of `8000`.
- `403` — The current user cannot follow other users. Returns a unique error code of `3417`.
- `429` — The current user is rate-limited from following other users. Returns a unique error code of `9006`.
- `500` — An unexpected error occurred. Returns a unique error code of `4005`.

## Changes

- **2018-12-05** `26f856a94041` — 2 info
  - api tag `Users\Follows` added
  - api tag `Users\Followers` removed

[Change history](https://skmtc.dev/vimeo/apis/vimeo-api/changes/users/:user_id/following/post.md)

---

[API](https://skmtc.dev/vimeo/apis/vimeo-api.md) · [All operations](https://skmtc.dev/vimeo/apis/vimeo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vimeo/vimeo-api/revisions/8e9ff8a1caf3/schema)