Skip to main content
Use these tools to read message history, send messages to groups or individuals, manage direct message conversations, and like or unlike messages.
Both send_message and send_direct_message accept a source_guid parameter. If you omit it, a UUID is auto-generated. The GroupMe API uses this value to deduplicate sends — submitting the same source_guid twice will not produce two messages.

​
list_messages

Retrieve messages from a group.
​
string
required
The ID of the group.
​
string
Return messages created before this message ID. Use for backward pagination.
​
string
Return messages created after this message ID. May skip messages if many were sent since that ID.
​
string
Return messages created immediately after this message ID.
​
number
default:"20"
Number of messages to return. Maximum is 100.
Example usage
“Get the last 50 messages from group 1234567.”

​
send_message

Send a message to a group.
​
string
required
The ID of the group.
​
string
required
Message text. Maximum 1000 characters.
​
string
Unique ID to prevent duplicate sends. A UUID is auto-generated if you leave this blank.
​
object[]
Optional list of attachment objects (image, location, emoji, etc.). Each attachment type requires a different shape — refer to the GroupMe API docs for the full attachment schema.
Example usage
“Send ‘See you at 7pm!’ to group 1234567.”

​
list_direct_messages

List direct messages with another user.
​
string
required
The ID of the other user in the conversation.
​
string
Return messages created before this message ID.
​
string
Return messages created after this message ID.
Example usage
“Show my direct message history with user 9876543.”

​
send_direct_message

Send a direct message to another user.
​
string
required
The user ID of the recipient.
​
string
required
Message text. Maximum 1000 characters.
​
string
Unique ID to prevent duplicate sends. A UUID is auto-generated if you leave this blank.
​
object[]
Optional list of attachment objects.
Example usage
“Send ‘Are you coming tonight?’ as a DM to user 9876543.”

​
list_chats

List the authenticated user’s direct message conversations, sorted by most recent activity.
​
number
default:"1"
Page number for pagination.
​
number
default:"20"
Number of chats per page.
Example usage
“Show my recent direct message conversations.”

​
like_message

Like a message.
conversation_id is the group ID for group messages, or the direct message conversation ID for DMs.
​
string
required
The group ID or direct message conversation ID.
​
string
required
The ID of the message to like.
Example usage
“Like message 111222 in group 1234567.”

​
unlike_message

Unlike a previously liked message.
​
string
required
The group ID or direct message conversation ID.
​
string
required
The ID of the message to unlike.
Example usage
“Remove my like from message 111222 in group 1234567.”