Skip to content
Docs

The workspace event log (the payloads webhooks receive) and the event type catalog.

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits3 endpointsMCP toolset webhooks

List event types

GET/events/names

Every event type a webhook can subscribe to, with its group and description.

Access: read

Try it with MCPAsk your agent to call list-event-types (toolset webhooks)Set up MCP

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
objectstring

event_type

typestring
groupstring
descriptionstring
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/events/names
curl "https://api.socialit.com/v1/events/names" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "list",
  "data": [
    {
      "object": "event_type",
      "type": "string",
      "group": "string",
      "description": "string"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}

List events

GET/events

Access: read

Try it with MCPAsk your agent to call list-events (toolset webhooks)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

created_at

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

typestring
profile_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
objectstring

event

idstring
typestring
profile_idstring | null
dataobject
created_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/events
curl "https://api.socialit.com/v1/events" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "list",
  "data": [
    {
      "object": "event",
      "id": "string",
      "type": "string",
      "profile_id": "string",
      "data": {},
      "created_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}

Get an event

GET/events/{id}

Access: read

Try it with MCPAsk your agent to call get-event (toolset webhooks)Set up MCP

Path parameters

idstringrequired

event id (evt_…)

1–80 characters

Returns object

objectstring

event

idstring
typestring
profile_idstring | null
dataobject
created_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/events/{id}
curl "https://api.socialit.com/v1/events/evt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "event",
  "id": "string",
  "type": "string",
  "profile_id": "string",
  "data": {},
  "created_at": "2026-10-13T09:00:00.000Z"
}