Direct Messages

Send DM

Send a direct message to a user. Provide either to_username or to_user_t2. Session cookies are optional when a Reddit session is connected through POST /api/reddit/session: a call that sends none acts as the stored session, and cookies you do send always win. Cost: $0.025 per call.

post/api/reddit/dm

Request

  • Base URL: https://api.redditapis.com
  • URL: https://api.redditapis.com/api/reddit/dm
  • Auth: HTTP bearer

Request body

to_usernamestring

Target username (resolved to t2_xxx). Provide this OR to_user_t2.

to_user_t2string

Target t2_xxx ID directly (skips username lookup, ~300ms faster).

messagestring required

Plain-text DM body

reddit_sessionstring

Account session cookie (from /api/reddit/login)

loidstring

Account loid cookie (from /api/reddit/login)

csrf_tokenstring

Reddit CSRF token cookie

Response

Successful response.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.