DM
Send a Reddit Direct Message via HTTP
Send a direct message to any Reddit user via a single HTTP call. No browser automation, no captcha at send time, just paste cookies and the message body.
POST
/api/reddit/dm$0.025 / callRequest Body
Cookies are passed as flat top-level fields (same shape as /comment and /vote).
| Field | Type | Required | Description |
|---|---|---|---|
to_username | string | one of | Target username (resolved internally to t2_xxx) |
to_user_t2 | string | one of | Target t2_xxx ID directly, skips the username lookup, ~300ms faster |
message | string | yes | Plain-text DM body |
reddit_session | string | yes | Session cookie from /api/reddit/login |
loid | string | yes | Long-lived account identifier cookie |
csrf_token | string | yes | Anti-CSRF cookie |
proxy | object | string | no | Sticky IP for this account, {server, username?, password?} or a URL string. Use the same proxy you passed to /login. Omit to use our pool. See Per-account proxies. |
Example
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{
"to_username": "Ok-Establishment9204",
"message": "hey!",
"reddit_session": "eyJhbGc...",
"loid": "000000...",
"csrf_token": "1c0819..."
}' \
"https://api.redditapis.com/api/reddit/dm"const response = await fetch("https://api.redditapis.com/api/reddit/dm", {
method: "POST",
headers: {
Authorization: "Bearer TOKEN",
"Content-Type": "application/json",
},
body: JSON.stringify({
to_username: "Ok-Establishment9204",
message: "hey!",
reddit_session: "eyJhbGc...",
loid: "000000...",
csrf_token: "1c0819...",
}),
});import requests
response = requests.post(
"https://api.redditapis.com/api/reddit/dm",
json={
"to_username": "Ok-Establishment9204",
"message": "hey!",
"reddit_session": "eyJhbGc...",
"loid": "000000...",
"csrf_token": "1c0819...",
},
headers={"Authorization": "Bearer TOKEN"},
)Success Response
{
"success": true,
"to": "t2_ugmf7dmn",
"room_id": "!hdstiJypyVtzbpoUJZe9mUc-zl-5BnADoRlS7h4itZg:reddit.com",
"event_id": "$u7UA6fbMCcnpk5Pzx-Gv71kDuaEKYbXv0SeamHSDCaQ"
}Errors
| Status | Meaning |
|---|---|
400 | Missing message, no recipient, bad to_user_t2 shape, or missing required cookies; or proxy is malformed (INVALID_PROXY), or a proxy-shaped field was sent as a top-level string (INVALID_FIELD), see Per-account proxies |
401 | Missing Bearer token |
403 | Invalid Bearer token |
502 | Could not send the DM, most commonly because the recipient restricts DMs to friends, or the sender account is shadowbanned/spam-flagged |
500 | Unexpected server error |
Independent third-party API for developers and researchers. Not affiliated with, endorsed by, or sponsored by Reddit, Inc.
VoteNew
Upvote, downvote, or clear your vote on any Reddit post or comment via a single HTTP call, auto-detects whether the target is a post or comment for you.
List DM ThreadsNew
List the account's direct-message conversations and chat sidebar, newest activity first, with full thread metadata, last message, and unread count.