Typing indicator and read receipts
API reference contents
POST direct_messages/mark_read
Marks a message as read in the recipient’s Direct Message conversation view with the sender.
Resource URL¶
https://api.twitter.com/1.1/direct_messages/mark_read.json
Resource Information¶
| Response formats | JSON |
| Content-Type | application/json |
| Requires authentication? | Yes (user context only) |
| Rate limited? | Yes |
| Requests / 15-min window (user auth) | 1000 / 15 minutes |
Parameters¶
| last_read_event_id (required) | The message ID of the most recent message to be marked read. All messages before it will be marked read as well. |
| recipient_id (required) | The user ID of the user the message is from. |
Example request using Twurl¶
twurl -X POST /1.1/direct_messages/mark_read.json -d "last_read_event_id=8754578330382663743" -d "recipient_id=3805104374"
HTTP Response Codes¶
Response contains no body.
| Code | Message |
|---|---|
| 204 | Typing indicator successfully sent. |
| 400 | Missing or invalid parameter(s) included in request. |
Webhook Event¶
Coming Soon: If using the Account Activity API, the following JSON payload will be sent to your webhook for all subscribed users.
{
"direct_message_mark_read_events": [
{
"created_timestamp": "1288834974657",
"sender_id": "2244994945",
"last_read_event_id": "877260925346103299",
"target": {
"recipient_id": "3805104374"
}
}
],
"users": {
// hydrated user objects
}
}
