Send things your users do besides posting content, such as joining or leaving a channel, removing or blocking another user, or liking a piece of content. Events use the same category and subcategory as content (a room, channel, thread, post or conversation) and show up between the content in its context and in the user's content history, so moderators can see what happened around a message.
An event type is created the first time you send its event.id; a later request with a
different event.name renames it. The number of event types is limited per plan (Free and
Starter 3, Pro 5, Enterprise 20). Events of a new type that would go over the limit are
rejected per item; the others are still stored. Delete event types you no longer send in
Settings → Events to free a slot.
Events are stored asynchronously. Up to 100 events per request.
Default rate limit: 300 requests per minute.
Responses
-
OK. At least one event was accepted;
rejectedlists the events that were not. -
The request is invalid, see the error field for details
-
The API token is missing or invalid
-
Every event in the request was rejected because of the event type limit.
-
The rate limit has been exceeded, check the X-RateLimit headers for limits
curl \
--request POST 'https://api.lassomoderation.com/api/v1/events' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"events": [
{
"event": {
"id": "join_channel",
"name": "Joined channel"
},
"user_id": "user_123",
"category": {
"id": "community",
"name": "Community"
},
"subcategory": {
"id": "general",
"name": "General"
},
"timestamp": "2026-11-12T14:02:31Z"
},
{
"event": {
"id": "like",
"name": "Liked"
},
"user_id": "user_123",
"content_id": "message_789",
"timestamp": "2026-11-12T14:03:10Z"
},
{
"event": {
"id": "add_credits",
"name": "Added credits"
},
"user_id": "user_123",
"value": 250,
"timestamp": "2026-11-12T14:04:12Z"
},
{
"event": {
"id": "block",
"name": "Blocked user"
},
"user_id": "buyer_42",
"target_user_id": "seller_7",
"category": {
"id": "marketplace",
"name": "Marketplace"
},
"subcategory": {
"id": "conversation_1138",
"name": "Bike listing chat"
},
"timestamp": "2026-11-12T14:05:02Z"
}
]
}'
{
"events": [
{
"event": {
"id": "join_channel",
"name": "Joined channel"
},
"user_id": "user_123",
"category": {
"id": "community",
"name": "Community"
},
"subcategory": {
"id": "general",
"name": "General"
},
"timestamp": "2026-11-12T14:02:31Z"
},
{
"event": {
"id": "like",
"name": "Liked"
},
"user_id": "user_123",
"content_id": "message_789",
"timestamp": "2026-11-12T14:03:10Z"
},
{
"event": {
"id": "add_credits",
"name": "Added credits"
},
"user_id": "user_123",
"value": 250,
"timestamp": "2026-11-12T14:04:12Z"
},
{
"event": {
"id": "block",
"name": "Blocked user"
},
"user_id": "buyer_42",
"target_user_id": "seller_7",
"category": {
"id": "marketplace",
"name": "Marketplace"
},
"subcategory": {
"id": "conversation_1138",
"name": "Bike listing chat"
},
"timestamp": "2026-11-12T14:05:02Z"
}
]
}
{
"success": true,
"data": {
"accepted": 3,
"rejected": []
}
}
{
"success": false,
"error": {
"content_id": "Value can be at most 100 characters"
}
}
{
"success": false,
"error": "Invalid API key"
}
{
"success": false,
"error": {
"message": "All events were rejected",
"rejected": [
{
"index": 0,
"event": "voice_mute",
"error": "string"
}
]
}
}
{
"error": "Too many requests, check headers for limits"
}