Skip to main content
The Direct Messages lookup endpoints let you retrieve DM events for the authenticated user, including messages from both one-to-one and group conversations.

Overview

All DM events

Get all DM events for the user

One-to-one

Get events from a specific conversation

By conversation ID

Get events by conversation ID

Event types

Messages, joins, and leaves

Endpoints

MethodEndpointDescription
GET/2/dm_eventsGet all DM events for the user
GET/2/dm_conversations/with/:participant_id/dm_eventsGet events from one-to-one conversation
GET/2/dm_conversations/:dm_conversation_id/dm_eventsGet events by conversation ID

Event types

EventDescription
MessageCreateA message was sent in the conversation
ParticipantsJoinA user joined the conversation
ParticipantsLeaveA user left the conversation

Data retention

Events from up to 30 days ago are available through these endpoints.

Getting started

Prerequisites