RedCrawler API
Messaging & Inbox & Notification

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

NameTypeRequiredDescription
tostringYesRecipient: Reddit username, u/name, or profile URL (e.g. https://www.reddit.com/user/Motor_Tip8865).
bodystringYesMessage text. The first 60 characters are also used as the subject line.
bearerstringNoReddit bearer token. Auto-resolves from your stored Token Vault entry.
proxystringNoProxy ip:port:user:pass. Auto-resolves from your stored Token Vault entry.

Authentication

HeaderValue
X-RapidAPI-KeyYour RapidAPI key
X-RapidAPI-Hostred-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"
}

On this page