User joined space

Fires when a member joins or is added to a space (not the creator, who is added automatically).


Event	`user.joined.space`
Code	204
Group	Spaces (200)
Since	2024-01-01 (sent by earlier versions; every existing key in `data` is kept)

Select the event user.joined.space or the whole Spaces group on your endpoint. Filters:

spaceIds: delivered only for the chosen spaces when set.

`data` fields

Field	Type	Always present
`member`	WebhookMember	❌ No
`role`	string \| object \| null	❌ No
`space`	WebhookSpace \| object	❌ No

Sample delivery

{
  "event": "user.joined.space",
  "timeStamp": 1792600000000,
  "data": {
    "member": {
      "id": "00000000-0000-4000-8000-000000000001",
      "name": "Ada Example",
      "email": "ada@example.com",
      "role": "Member",
      "profileUrl": "https://community.example.com/profile/00000000-0000-4000-8000-000000000001",
      "avatarUrl": "https://community.example.com/avatars/ada.png"
    },
    "joinSource": "direct",
    "userId": "00000000-0000-4000-8000-000000000001",
    "name": "Ada Example",
    "email": "ada@example.com",
    "role": {
      "roleId": "00000000-0000-4000-8000-000000000030",
      "name": "Member",
      "type": "member"
    },
    "space": {
      "id": "00000000-0000-4000-8000-000000000003",
      "name": "Founders",
      "url": "https://community.example.com/spaces/00000000-0000-4000-8000-000000000003",
      "isPrivate": false,
      "spaceId": "00000000-0000-4000-8000-000000000003",
      "image": null,
      "about": null
    }
  },
  "id": "evt_8f2b1c3d-4e5f-4a6b-9c7d-0e1f2a3b4c5d",
  "code": 204,
  "group": "spaces",
  "version": "2026-10-21",
  "communityId": "64f1c0ffee0000000000c0de",
  "occurredAt": "2026-10-21T15:00:00.000Z",
  "attempt": 1,
  "isTest": false
}

Handling

Verify x-networked-signature against the raw body before you trust the request.

Answer any 2xx within 10 seconds and process the event afterwards.

Deduplicate on id: retries and resends carry the same id.

Ignore keys and event types you do not handle; keys may be added, never removed or renamed.

curl --location 'https://your-api-server.com' \ --header 'x-networked-signature: t=1792600000,v1=5f1a…' \ --header 'x-networked-event: user.joined.space' \ --header 'x-networked-event-id: evt_8f2b1c3d-4e5f-4a6b-9c7d-0e1f2a3b4c5d' \ --header 'x-networked-event-code: 204' \ --header 'x-networked-delivery-id: dlv_2c9e1a7b-3f4d-4b5e-8a6c-7d8e9f0a1b2c' \ --header 'x-webhook-signature: 9a3c…' \ --header 'x-webhook-timestamp: 1792600000000' \ --header 'Content-Type: application/json' \ --data-raw '{ "event": "user.joined.space", "timeStamp": 1792600000000, "data": { "member": { "id": "00000000-0000-4000-8000-000000000001", "name": "Ada Example", "email": "ada@example.com", "role": "Member", "profileUrl": "https://community.example.com/profile/00000000-0000-4000-8000-000000000001", "avatarUrl": "https://community.example.com/avatars/ada.png" }, "joinSource": "direct", "userId": "00000000-0000-4000-8000-000000000001", "name": "Ada Example", "email": "ada@example.com", "role": { "roleId": "00000000-0000-4000-8000-000000000030", "name": "Member", "type": "member" }, "space": { "id": "00000000-0000-4000-8000-000000000003", "name": "Founders", "url": "https://community.example.com/spaces/00000000-0000-4000-8000-000000000003", "isPrivate": false, "spaceId": "00000000-0000-4000-8000-000000000003", "image": null, "about": null } }, "id": "evt_8f2b1c3d-4e5f-4a6b-9c7d-0e1f2a3b4c5d", "code": 204, "group": "spaces", "version": "2026-10-21", "communityId": "64f1c0ffee0000000000c0de", "occurredAt": "2026-10-21T15:00:00.000Z", "attempt": 1, "isTest": false }'

User joined space