Send Chat DM
Send a Reddit Chat direct message to another user. The `to` field accepts: a raw Reddit username, a `u/name` string, or a full profile URL (e.g. `https://www.re
POST /api/v2/inbox/chat-send
Send a Reddit Chat direct message to another user. The to field accepts: a raw Reddit username, a u/name string, or a full profile URL (e.g. https://www.reddit.com/user/Motor_Tip8865). If the recipient has restricted DMs you'll receive a RESTRICTED_TO_PM error. Requires bearer token.
Body parameters
| Name | Type | Required | Description |
|---|---|---|---|
to | string | Yes | Recipient: Reddit username, u/name, or profile URL (e.g. https://www.reddit.com/user/Motor_Tip8865). |
body | string | Yes | Message text. The first 60 characters are also used as the subject line. |
bearer | string | No | Reddit bearer token. Auto-resolves from your stored Token Vault entry. |
proxy | string | No | Proxy ip:port:user:pass. Auto-resolves from your stored Token Vault entry. |
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/v2/inbox/chat-send" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com" \
-H "Content-Type: application/json" \
--data '{"to": "Motor_Tip8865", "body": "Hello from RedCrawler", "bearer": "<bearer>", "proxy": "<proxy>"}'JavaScript
const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v2/inbox/chat-send", {
method: "POST",
headers: {
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
},
body: JSON.stringify({
"to": "Motor_Tip8865",
"body": "Hello from RedCrawler",
"bearer": "<bearer>",
"proxy": "<proxy>"
})
});
const data = await res.json();
console.log(data);Python
import requests
url = "https://red-crawler1.p.rapidapi.com/api/v2/inbox/chat-send"
headers = {
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "red-crawler1.p.rapidapi.com",
"Content-Type": "application/json"
}
payload = {
"to": "Motor_Tip8865",
"body": "Hello from RedCrawler",
"bearer": "<bearer>",
"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": {
"sent": true,
"recipient": "spez",
"redditor_id": "t2_1w72"
},
"error": null,
"meta": {
"vault_expires_at": "2026-04-30T07:47:21.906002+00:00",
"vault_remaining": "19h 53m"
},
"timestamp": "2026-04-29T11:53:41.501181+00:00"
}Load Inbox Feed
Fetch the authenticated user's Reddit inbox notification feed — replies, mentions, mod actions, achievements, and chat invites. Returns paginated items with tit
Load Chat Threads
Load the authenticated user's Reddit chat threads (1:1 DMs + group chats). Returns rooms with name, partner, last message, last sender, last timestamp, unread c