# Events API

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

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## List event types

`GET /events/names`

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

Access: `read` · MCP tool: `list-event-types`

```bash
curl "https://api.socialit.com/v1/events/names" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "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` · MCP tool: `list-events`

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of created_at)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `type` (string)
- `profile_id` (string)

```bash
curl "https://api.socialit.com/v1/events" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "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` · MCP tool: `get-event`

### Path parameters

- `id` (string; required; 1–80 characters): event id (evt_…)

```bash
curl "https://api.socialit.com/v1/events/evt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "event",
  "id": "string",
  "type": "string",
  "profile_id": "string",
  "data": {},
  "created_at": "2026-10-13T09:00:00.000Z"
}
```


---

Source: https://socialit.com/docs/api-reference/events/
