Set User Flair V1

Set or clear a user's flair in a subreddit. Two modes: - **Template-based**: Provide `flair_template_id` (and optional `text` override). Uses Reddit's `/api/se

POST /api/v1/communities/{name}/set-user-flair

Set or clear a user's flair in a subreddit.

Two modes:

Template-based: Provide flair_template_id (and optional text override). Uses Reddit's /api/selectflair.
Custom text: Provide text and/or css_class without a template. Uses Reddit's /api/flair.

Omit all flair fields to clear the user's flair.

Requires bearer token with moderator privileges.

Path parameters

Name	Type	Required	Description
`name`	string	Yes	Subreddit name (e.g. test).

Body parameters

Name	Type	Required	Description
`username`	string	Yes	Reddit username to flair.
`flair_template_id`	string	No	Flair template UUID. Get templates from User Flair Options V1.
`text`	string	No	Custom flair text (max 64 chars). Overrides template text if both provided. Leave empty to clear.
`bearer`	string	No	Bearer token. Optional if stored in Token Vault.
`css_class`	string	No	CSS class for old-reddit flair styling. Only used in custom text mode.
`proxy`	string	No	Proxy. Optional if stored in Token Vault.

Authentication

Header	Value
`X-RapidAPI-Key`	Your RapidAPI key
`X-RapidAPI-Host`	`red-crawler1.p.rapidapi.com`

Example request

cURL

curl -X POST "https://red-crawler1.p.rapidapi.com/api/v1/communities/test/set-user-flair" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  --data '{"username": "Motor_Tip8865", "flair_template_id": "<flair_template_id>", "text": "<text>", "bearer": "<bearer>", "css_class": "<css_class>", "proxy": "<proxy>"}'

JavaScript

const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v1/communities/test/set-user-flair", {
  method: "POST",
  headers: {
      "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
    },
    body: JSON.stringify({
  "username": "Motor_Tip8865",
  "flair_template_id": "<flair_template_id>",
  "text": "<text>",
  "bearer": "<bearer>",
  "css_class": "<css_class>",
  "proxy": "<proxy>"
})
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://red-crawler1.p.rapidapi.com/api/v1/communities/test/set-user-flair"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com",
    "Content-Type": "application/json"
}
payload = {
  "username": "Motor_Tip8865",
  "flair_template_id": "<flair_template_id>",
  "text": "<text>",
  "bearer": "<bearer>",
  "css_class": "<css_class>",
  "proxy": "<proxy>"
}
resp = requests.post(url, headers=headers, json=payload)
print(resp.json())

Example response

HTTP 200 — captured from a live call to the gateway.

{
  "success": true,
  "data": {
    "json": {
      "errors": []
    }
  },
  "error": null,
  "timestamp": "2026-04-29T10:34:08.701259+00:00"
}

Set User Flair V1

On this page