Back to top

API Documentation

Room

Overview

A Room is basically a place where any number of rechat users (> 1) could chat.

Although the Room is basically a chat room, some other objects could be attached to it. Other concepts of Rechat like Alerts and recommendations are heavily linked to rooms.

It is important to remember that even a private discussion between two people happens on a chat room.

Get a user's Rooms

Get a user's Rooms
GET/rooms

Example URI

GET /rooms
URI Parameters
HideShow
associations
string (required) Example: room.owner,room.latest_message,room.users
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "type": "room",
      "id": "f1978727-25ef-4711-b40a-619c0621be76",
      "title": null,
      "owner": null,
      "created_at": 1765163626.718649,
      "updated_at": 1765163626.759588,
      "deleted_at": null,
      "room_type": "Direct",
      "new_notifications": 0,
      "latest_message": {
        "type": "message",
        "mid": "d38d29d0-b6a5-4c49-9ac4-b576e2e4a23a",
        "id": "d38d29d0-b6a5-4c49-9ac4-b576e2e4a23a",
        "comment": "Unit invited [email protected] to join.",
        "image_url": null,
        "document_url": null,
        "video_url": null,
        "recommendation": null,
        "author": null,
        "created_at": 1765163626.759588,
        "updated_at": 1765163626.759588,
        "room": "f1978727-25ef-4711-b40a-619c0621be76",
        "image_thumbnail_url": null,
        "deleted_at": null,
        "notification": {
          "type": "notification",
          "id": "5dbb100a-93e6-415c-9a30-1a76ccabd36d",
          "object": "f1978727-25ef-4711-b40a-619c0621be76",
          "message": "Unit invited [email protected] to join.",
          "created_at": 1765163626.748232,
          "updated_at": 1765163626.748232,
          "room": "f1978727-25ef-4711-b40a-619c0621be76",
          "action": "Invited",
          "object_class": "Room",
          "subject": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
          "auxiliary_object_class": "User",
          "auxiliary_object": {
            "type": "user",
            "username": null,
            "first_name": "[email protected]",
            "last_name": "",
            "email": "[email protected]",
            "phone_number": null,
            "created_at": 1765163626.650024,
            "id": "ce106743-36b9-45e7-801b-fab68269fb8d",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1765163626.650045,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": false,
            "timezone": "America/Chicago",
            "user_type": "Client",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": true,
            "personal_room": "b0f13719-0b8c-427a-ac64-944921692775",
            "brand": null,
            "fake_email": null,
            "features": null,
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": null,
            "current_time": "9:13 PM - Sunday Dec 07, 2025",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "[email protected] ",
            "abbreviated_display_name": "[email protected]",
            "online_state": "Offline",
            "has_password": false
          },
          "recommendation": null,
          "auxiliary_subject": null,
          "subject_class": "User",
          "auxiliary_subject_class": null,
          "extra_subject_class": null,
          "extra_object_class": null,
          "deleted_at": null,
          "specific": null,
          "title": null,
          "data": null,
          "sound": null,
          "app": "rechat",
          "transports": null,
          "phone_number": null,
          "notification_type": "UserInvitedRoom",
          "seen": true,
          "recommendations": null,
          "objects": null,
          "subjects": [
            {
              "type": "user",
              "username": null,
              "first_name": "Unit",
              "last_name": "Test",
              "email": "[email protected]",
              "phone_number": "+4368120265807",
              "created_at": 1493115498.770362,
              "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
              "address_id": null,
              "cover_image_url": null,
              "profile_image_url": null,
              "updated_at": 1493115498.770744,
              "user_status": "Active",
              "profile_image_thumbnail_url": null,
              "cover_image_thumbnail_url": null,
              "email_confirmed": true,
              "timezone": "America/Chicago",
              "user_type": "Admin",
              "deleted_at": null,
              "phone_confirmed": false,
              "is_shadow": false,
              "personal_room": null,
              "brand": null,
              "fake_email": false,
              "features": [
                "Deals"
              ],
              "last_seen_at": null,
              "email_signature": null,
              "daily_enabled": false,
              "email_quota": 30000,
              "website": null,
              "instagram": null,
              "twitter": null,
              "linkedin": null,
              "youtube": null,
              "facebook": null,
              "designation": null,
              "tiktok": null,
              "mfa_enabled": false,
              "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
              "current_time": "9:13 PM - Sunday Dec 07, 2025",
              "push_allowed": true,
              "agents": null,
              "last_seen_type": null,
              "active_brand": null,
              "display_name": "Unit Test",
              "abbreviated_display_name": "Unit",
              "online_state": "Offline",
              "has_password": true
            }
          ]
        },
        "reference": null,
        "mentions": null,
        "activity": null,
        "role": null,
        "attachments": [],
        "files": null,
        "email_campaigns": null,
        "contacts": null,
        "crm_tasks": null,
        "compact_listings": null,
        "input_forms": null,
        "websites": null,
        "social_posts": null,
        "print_campaigns": null,
        "template_instances": null,
        "brand_assets": null,
        "acked_by": null,
        "deliveries": null
      },
      "notification_settings": {
        "80a227b2-29a0-11e7-b636-e4a7a08e15d4": "N_ALL"
      },
      "users": [
        {
          "type": "user",
          "username": null,
          "first_name": "Unit",
          "last_name": "Test",
          "email": "[email protected]",
          "phone_number": "+4368120265807",
          "created_at": 1493115498.770362,
          "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1493115498.770744,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": true,
          "timezone": "America/Chicago",
          "user_type": "Admin",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": false,
          "personal_room": null,
          "brand": null,
          "fake_email": false,
          "features": [
            "Deals"
          ],
          "last_seen_at": null,
          "email_signature": null,
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
          "current_time": "9:13 PM - Sunday Dec 07, 2025",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "Unit Test",
          "abbreviated_display_name": "Unit",
          "online_state": "Offline",
          "has_password": true
        },
        {
          "type": "user",
          "username": null,
          "first_name": "[email protected]",
          "last_name": "",
          "email": "[email protected]",
          "phone_number": null,
          "created_at": 1765163626.650024,
          "id": "ce106743-36b9-45e7-801b-fab68269fb8d",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1765163626.650045,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": false,
          "timezone": "America/Chicago",
          "user_type": "Client",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": true,
          "personal_room": "b0f13719-0b8c-427a-ac64-944921692775",
          "brand": null,
          "fake_email": null,
          "features": null,
          "last_seen_at": null,
          "email_signature": null,
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": null,
          "current_time": "9:13 PM - Sunday Dec 07, 2025",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "[email protected] ",
          "abbreviated_display_name": "[email protected]",
          "online_state": "Offline",
          "has_password": false
        }
      ],
      "total_alerts": null,
      "total_favorites": null,
      "proposed_title": "[email protected]"
    },
    {
      "type": "room",
      "id": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
      "title": "sampleroom",
      "owner": {
        "type": "user",
        "username": null,
        "first_name": "Unit",
        "last_name": "Test",
        "email": "[email protected]",
        "phone_number": "+4368120265807",
        "created_at": 1493115498.770362,
        "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1493115498.770744,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": true,
        "timezone": "America/Chicago",
        "user_type": "Admin",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": false,
        "personal_room": null,
        "brand": null,
        "fake_email": false,
        "features": [
          "Deals"
        ],
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "current_time": "9:13 PM - Sunday Dec 07, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "Unit Test",
        "abbreviated_display_name": "Unit",
        "online_state": "Offline",
        "has_password": true
      },
      "created_at": 1765163626.204119,
      "updated_at": 1765163626.409239,
      "deleted_at": null,
      "room_type": "Group",
      "new_notifications": 0,
      "latest_message": {
        "type": "message",
        "mid": "49b6ec4d-6f55-4fce-adaf-5f9d95ad10ee",
        "id": "49b6ec4d-6f55-4fce-adaf-5f9d95ad10ee",
        "comment": "Unit invited +18598161689 to join.",
        "image_url": null,
        "document_url": null,
        "video_url": null,
        "recommendation": null,
        "author": null,
        "created_at": 1765163626.409239,
        "updated_at": 1765163626.409239,
        "room": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
        "image_thumbnail_url": null,
        "deleted_at": null,
        "notification": {
          "type": "notification",
          "id": "a3bf839c-8220-4c64-8faf-61f6253eb826",
          "object": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
          "message": "Unit invited +18598161689 to join.",
          "created_at": 1765163626.395782,
          "updated_at": 1765163626.395782,
          "room": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
          "action": "Invited",
          "object_class": "Room",
          "subject": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
          "auxiliary_object_class": "User",
          "auxiliary_object": {
            "type": "user",
            "username": null,
            "first_name": "",
            "last_name": "",
            "email": "[email protected]",
            "phone_number": "+18598161689",
            "created_at": 1765163626.069971,
            "id": "76eed142-acf0-43cb-9009-fc0e234f72c0",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1765163626.069978,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": false,
            "timezone": "America/Chicago",
            "user_type": "Client",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": true,
            "personal_room": "8c16b1d1-1b37-4e25-9294-8de2af8d4017",
            "brand": null,
            "fake_email": true,
            "features": null,
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": null,
            "current_time": "9:13 PM - Sunday Dec 07, 2025",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "+18598161689",
            "abbreviated_display_name": "+18598161689",
            "online_state": "Offline",
            "has_password": false
          },
          "recommendation": null,
          "auxiliary_subject": null,
          "subject_class": "User",
          "auxiliary_subject_class": null,
          "extra_subject_class": null,
          "extra_object_class": null,
          "deleted_at": null,
          "specific": null,
          "title": null,
          "data": null,
          "sound": null,
          "app": "rechat",
          "transports": null,
          "phone_number": null,
          "notification_type": "UserInvitedRoom",
          "seen": true,
          "recommendations": null,
          "objects": null,
          "subjects": [
            {
              "type": "user",
              "username": null,
              "first_name": "Unit",
              "last_name": "Test",
              "email": "[email protected]",
              "phone_number": "+4368120265807",
              "created_at": 1493115498.770362,
              "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
              "address_id": null,
              "cover_image_url": null,
              "profile_image_url": null,
              "updated_at": 1493115498.770744,
              "user_status": "Active",
              "profile_image_thumbnail_url": null,
              "cover_image_thumbnail_url": null,
              "email_confirmed": true,
              "timezone": "America/Chicago",
              "user_type": "Admin",
              "deleted_at": null,
              "phone_confirmed": false,
              "is_shadow": false,
              "personal_room": null,
              "brand": null,
              "fake_email": false,
              "features": [
                "Deals"
              ],
              "last_seen_at": null,
              "email_signature": null,
              "daily_enabled": false,
              "email_quota": 30000,
              "website": null,
              "instagram": null,
              "twitter": null,
              "linkedin": null,
              "youtube": null,
              "facebook": null,
              "designation": null,
              "tiktok": null,
              "mfa_enabled": false,
              "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
              "current_time": "9:13 PM - Sunday Dec 07, 2025",
              "push_allowed": true,
              "agents": null,
              "last_seen_type": null,
              "active_brand": null,
              "display_name": "Unit Test",
              "abbreviated_display_name": "Unit",
              "online_state": "Offline",
              "has_password": true
            }
          ]
        },
        "reference": null,
        "mentions": null,
        "activity": null,
        "role": null,
        "attachments": [],
        "files": null,
        "email_campaigns": null,
        "contacts": null,
        "crm_tasks": null,
        "compact_listings": null,
        "input_forms": null,
        "websites": null,
        "social_posts": null,
        "print_campaigns": null,
        "template_instances": null,
        "brand_assets": null,
        "acked_by": null,
        "deliveries": [
          {
            "user": "76eed142-acf0-43cb-9009-fc0e234f72c0",
            "delivery_type": "sms",
            "type": "notification_delivery",
            "created_at": "2025-12-08T03:13:46.559027+00:00"
          }
        ]
      },
      "notification_settings": {
        "80a227b2-29a0-11e7-b636-e4a7a08e15d4": "N_ALL"
      },
      "users": [
        {
          "type": "user",
          "username": null,
          "first_name": "[email protected]",
          "last_name": "",
          "email": "[email protected]",
          "phone_number": null,
          "created_at": 1765163626.068701,
          "id": "65ed748a-5b9a-400a-b541-9186349aaae3",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1765163626.068727,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": false,
          "timezone": "America/Chicago",
          "user_type": "Client",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": true,
          "personal_room": "3369258f-5eb3-4d6f-9336-6ea43aae7019",
          "brand": null,
          "fake_email": null,
          "features": null,
          "last_seen_at": null,
          "email_signature": null,
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": null,
          "current_time": "9:13 PM - Sunday Dec 07, 2025",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "[email protected] ",
          "abbreviated_display_name": "[email protected]",
          "online_state": "Offline",
          "has_password": false
        },
        {
          "type": "user",
          "username": null,
          "first_name": "",
          "last_name": "",
          "email": "[email protected]",
          "phone_number": "+18598161689",
          "created_at": 1765163626.069971,
          "id": "76eed142-acf0-43cb-9009-fc0e234f72c0",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1765163626.069978,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": false,
          "timezone": "America/Chicago",
          "user_type": "Client",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": true,
          "personal_room": "8c16b1d1-1b37-4e25-9294-8de2af8d4017",
          "brand": null,
          "fake_email": true,
          "features": null,
          "last_seen_at": null,
          "email_signature": null,
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": null,
          "current_time": "9:13 PM - Sunday Dec 07, 2025",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "+18598161689",
          "abbreviated_display_name": "+18598161689",
          "online_state": "Offline",
          "has_password": false
        },
        {
          "type": "user",
          "username": null,
          "first_name": "Unit",
          "last_name": "Test",
          "email": "[email protected]",
          "phone_number": "+4368120265807",
          "created_at": 1493115498.770362,
          "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1493115498.770744,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": true,
          "timezone": "America/Chicago",
          "user_type": "Admin",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": false,
          "personal_room": null,
          "brand": null,
          "fake_email": false,
          "features": [
            "Deals"
          ],
          "last_seen_at": null,
          "email_signature": null,
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
          "current_time": "9:13 PM - Sunday Dec 07, 2025",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "Unit Test",
          "abbreviated_display_name": "Unit",
          "online_state": "Offline",
          "has_password": true
        }
      ],
      "total_alerts": null,
      "total_favorites": null,
      "proposed_title": "[email protected], +18598161689"
    }
  ],
  "info": {
    "count": 2,
    "total": 2,
    "new": 0
  }
}

Create Room

Create Room
POST/rooms

Example URI

POST /rooms
URI Parameters
HideShow
associations
string (required) Example: room.owner,room.latest_message,room.users
Request
HideShow
Body
{
  "title": "sampleroom",
  "room_type": "Group",
  "phone_numbers": [
    "+18598161689"
  ],
  "emails": [
    "[email protected]"
  ],
  "owner": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
  "users": [
    {
      "user_id": "65ed748a-5b9a-400a-b541-9186349aaae3"
    },
    {
      "user_id": "76eed142-acf0-43cb-9009-fc0e234f72c0"
    }
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "type": "room",
    "id": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
    "title": "sampleroom",
    "owner": {
      "type": "user",
      "username": null,
      "first_name": "Unit",
      "last_name": "Test",
      "email": "[email protected]",
      "phone_number": "+4368120265807",
      "created_at": 1493115498.770362,
      "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "address_id": null,
      "cover_image_url": null,
      "profile_image_url": null,
      "updated_at": 1493115498.770744,
      "user_status": "Active",
      "profile_image_thumbnail_url": null,
      "cover_image_thumbnail_url": null,
      "email_confirmed": true,
      "timezone": "America/Chicago",
      "user_type": "Admin",
      "deleted_at": null,
      "phone_confirmed": false,
      "is_shadow": false,
      "personal_room": null,
      "brand": null,
      "fake_email": false,
      "features": [
        "Deals"
      ],
      "last_seen_at": null,
      "email_signature": null,
      "daily_enabled": false,
      "email_quota": 30000,
      "website": null,
      "instagram": null,
      "twitter": null,
      "linkedin": null,
      "youtube": null,
      "facebook": null,
      "designation": null,
      "tiktok": null,
      "mfa_enabled": false,
      "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "current_time": "9:13 PM - Sunday Dec 07, 2025",
      "push_allowed": true,
      "agents": null,
      "last_seen_type": null,
      "active_brand": null,
      "display_name": "Unit Test",
      "abbreviated_display_name": "Unit",
      "online_state": "Offline",
      "has_password": true
    },
    "created_at": 1765163626.204119,
    "updated_at": 1765163626.409239,
    "deleted_at": null,
    "room_type": "Group",
    "new_notifications": 0,
    "latest_message": {
      "type": "message",
      "mid": "49b6ec4d-6f55-4fce-adaf-5f9d95ad10ee",
      "id": "49b6ec4d-6f55-4fce-adaf-5f9d95ad10ee",
      "comment": "Unit invited +18598161689 to join.",
      "image_url": null,
      "document_url": null,
      "video_url": null,
      "recommendation": null,
      "author": null,
      "created_at": 1765163626.409239,
      "updated_at": 1765163626.409239,
      "room": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
      "image_thumbnail_url": null,
      "deleted_at": null,
      "notification": {
        "type": "notification",
        "id": "a3bf839c-8220-4c64-8faf-61f6253eb826",
        "object": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
        "message": "Unit invited +18598161689 to join.",
        "created_at": 1765163626.395782,
        "updated_at": 1765163626.395782,
        "room": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
        "action": "Invited",
        "object_class": "Room",
        "subject": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "auxiliary_object_class": "User",
        "auxiliary_object": {
          "type": "user",
          "username": null,
          "first_name": "",
          "last_name": "",
          "email": "[email protected]",
          "phone_number": "+18598161689",
          "created_at": 1765163626.069971,
          "id": "76eed142-acf0-43cb-9009-fc0e234f72c0",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1765163626.069978,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": false,
          "timezone": "America/Chicago",
          "user_type": "Client",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": true,
          "personal_room": "8c16b1d1-1b37-4e25-9294-8de2af8d4017",
          "brand": null,
          "fake_email": true,
          "features": null,
          "last_seen_at": null,
          "email_signature": null,
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": null,
          "current_time": "9:13 PM - Sunday Dec 07, 2025",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "+18598161689",
          "abbreviated_display_name": "+18598161689",
          "online_state": "Offline",
          "has_password": false
        },
        "recommendation": null,
        "auxiliary_subject": null,
        "subject_class": "User",
        "auxiliary_subject_class": null,
        "extra_subject_class": null,
        "extra_object_class": null,
        "deleted_at": null,
        "specific": null,
        "title": null,
        "data": null,
        "sound": null,
        "app": "rechat",
        "transports": null,
        "phone_number": null,
        "notification_type": "UserInvitedRoom",
        "seen": true,
        "recommendations": null,
        "objects": null,
        "subjects": [
          {
            "type": "user",
            "username": null,
            "first_name": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "current_time": "9:13 PM - Sunday Dec 07, 2025",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "online_state": "Offline",
            "has_password": true
          }
        ]
      },
      "reference": null,
      "mentions": null,
      "activity": null,
      "role": null,
      "attachments": [],
      "files": null,
      "email_campaigns": null,
      "contacts": null,
      "crm_tasks": null,
      "compact_listings": null,
      "input_forms": null,
      "websites": null,
      "social_posts": null,
      "print_campaigns": null,
      "template_instances": null,
      "brand_assets": null,
      "acked_by": null,
      "deliveries": [
        {
          "user": "76eed142-acf0-43cb-9009-fc0e234f72c0",
          "delivery_type": "sms",
          "type": "notification_delivery",
          "created_at": "2025-12-08T03:13:46.559027+00:00"
        }
      ]
    },
    "notification_settings": {
      "80a227b2-29a0-11e7-b636-e4a7a08e15d4": "N_ALL"
    },
    "users": [
      {
        "type": "user",
        "username": null,
        "first_name": "[email protected]",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": null,
        "created_at": 1765163626.068701,
        "id": "65ed748a-5b9a-400a-b541-9186349aaae3",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1765163626.068727,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Client",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": true,
        "personal_room": "3369258f-5eb3-4d6f-9336-6ea43aae7019",
        "brand": null,
        "fake_email": null,
        "features": null,
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "current_time": "9:13 PM - Sunday Dec 07, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "[email protected] ",
        "abbreviated_display_name": "[email protected]",
        "online_state": "Offline",
        "has_password": false
      },
      {
        "type": "user",
        "username": null,
        "first_name": "",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": "+18598161689",
        "created_at": 1765163626.069971,
        "id": "76eed142-acf0-43cb-9009-fc0e234f72c0",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1765163626.069978,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Client",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": true,
        "personal_room": "8c16b1d1-1b37-4e25-9294-8de2af8d4017",
        "brand": null,
        "fake_email": true,
        "features": null,
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "current_time": "9:13 PM - Sunday Dec 07, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "+18598161689",
        "abbreviated_display_name": "+18598161689",
        "online_state": "Offline",
        "has_password": false
      },
      {
        "type": "user",
        "username": null,
        "first_name": "Unit",
        "last_name": "Test",
        "email": "[email protected]",
        "phone_number": "+4368120265807",
        "created_at": 1493115498.770362,
        "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1493115498.770744,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": true,
        "timezone": "America/Chicago",
        "user_type": "Admin",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": false,
        "personal_room": null,
        "brand": null,
        "fake_email": false,
        "features": [
          "Deals"
        ],
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "current_time": "9:13 PM - Sunday Dec 07, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "Unit Test",
        "abbreviated_display_name": "Unit",
        "online_state": "Offline",
        "has_password": true
      }
    ],
    "total_alerts": null,
    "total_favorites": null,
    "proposed_title": "[email protected], +18598161689"
  }
}

Get Room

Get Room
GET/rooms/{id}

Example URI

GET /rooms/7c0c7439-baf5-4c0f-aaa1-134fceb44a26
URI Parameters
HideShow
id
string (required) Example: 7c0c7439-baf5-4c0f-aaa1-134fceb44a26
associations
string (required) Example: room.owner,room.latest_message,room.users
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "type": "room",
    "id": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
    "title": "sampleroom",
    "owner": {
      "type": "user",
      "username": null,
      "first_name": "Unit",
      "last_name": "Test",
      "email": "[email protected]",
      "phone_number": "+4368120265807",
      "created_at": 1493115498.770362,
      "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "address_id": null,
      "cover_image_url": null,
      "profile_image_url": null,
      "updated_at": 1493115498.770744,
      "user_status": "Active",
      "profile_image_thumbnail_url": null,
      "cover_image_thumbnail_url": null,
      "email_confirmed": true,
      "timezone": "America/Chicago",
      "user_type": "Admin",
      "deleted_at": null,
      "phone_confirmed": false,
      "is_shadow": false,
      "personal_room": null,
      "brand": null,
      "fake_email": false,
      "features": [
        "Deals"
      ],
      "last_seen_at": null,
      "email_signature": null,
      "daily_enabled": false,
      "email_quota": 30000,
      "website": null,
      "instagram": null,
      "twitter": null,
      "linkedin": null,
      "youtube": null,
      "facebook": null,
      "designation": null,
      "tiktok": null,
      "mfa_enabled": false,
      "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "current_time": "9:13 PM - Sunday Dec 07, 2025",
      "push_allowed": true,
      "agents": null,
      "last_seen_type": null,
      "active_brand": null,
      "display_name": "Unit Test",
      "abbreviated_display_name": "Unit",
      "online_state": "Offline",
      "has_password": true
    },
    "created_at": 1765163626.204119,
    "updated_at": 1765163626.409239,
    "deleted_at": null,
    "room_type": "Group",
    "new_notifications": 0,
    "latest_message": {
      "type": "message",
      "mid": "49b6ec4d-6f55-4fce-adaf-5f9d95ad10ee",
      "id": "49b6ec4d-6f55-4fce-adaf-5f9d95ad10ee",
      "comment": "Unit invited +18598161689 to join.",
      "image_url": null,
      "document_url": null,
      "video_url": null,
      "recommendation": null,
      "author": null,
      "created_at": 1765163626.409239,
      "updated_at": 1765163626.409239,
      "room": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
      "image_thumbnail_url": null,
      "deleted_at": null,
      "notification": {
        "type": "notification",
        "id": "a3bf839c-8220-4c64-8faf-61f6253eb826",
        "object": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
        "message": "Unit invited +18598161689 to join.",
        "created_at": 1765163626.395782,
        "updated_at": 1765163626.395782,
        "room": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
        "action": "Invited",
        "object_class": "Room",
        "subject": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "auxiliary_object_class": "User",
        "auxiliary_object": {
          "type": "user",
          "username": null,
          "first_name": "",
          "last_name": "",
          "email": "[email protected]",
          "phone_number": "+18598161689",
          "created_at": 1765163626.069971,
          "id": "76eed142-acf0-43cb-9009-fc0e234f72c0",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1765163626.069978,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": false,
          "timezone": "America/Chicago",
          "user_type": "Client",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": true,
          "personal_room": "8c16b1d1-1b37-4e25-9294-8de2af8d4017",
          "brand": null,
          "fake_email": true,
          "features": null,
          "last_seen_at": null,
          "email_signature": null,
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": null,
          "current_time": "9:13 PM - Sunday Dec 07, 2025",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "+18598161689",
          "abbreviated_display_name": "+18598161689",
          "online_state": "Offline",
          "has_password": false
        },
        "recommendation": null,
        "auxiliary_subject": null,
        "subject_class": "User",
        "auxiliary_subject_class": null,
        "extra_subject_class": null,
        "extra_object_class": null,
        "deleted_at": null,
        "specific": null,
        "title": null,
        "data": null,
        "sound": null,
        "app": "rechat",
        "transports": null,
        "phone_number": null,
        "notification_type": "UserInvitedRoom",
        "seen": true,
        "recommendations": null,
        "objects": null,
        "subjects": [
          {
            "type": "user",
            "username": null,
            "first_name": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "current_time": "9:13 PM - Sunday Dec 07, 2025",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "online_state": "Offline",
            "has_password": true
          }
        ]
      },
      "reference": null,
      "mentions": null,
      "activity": null,
      "role": null,
      "attachments": [],
      "files": null,
      "email_campaigns": null,
      "contacts": null,
      "crm_tasks": null,
      "compact_listings": null,
      "input_forms": null,
      "websites": null,
      "social_posts": null,
      "print_campaigns": null,
      "template_instances": null,
      "brand_assets": null,
      "acked_by": null,
      "deliveries": [
        {
          "user": "76eed142-acf0-43cb-9009-fc0e234f72c0",
          "delivery_type": "sms",
          "type": "notification_delivery",
          "created_at": "2025-12-08T03:13:46.559027+00:00"
        }
      ]
    },
    "notification_settings": {
      "80a227b2-29a0-11e7-b636-e4a7a08e15d4": "N_ALL"
    },
    "users": [
      {
        "type": "user",
        "username": null,
        "first_name": "[email protected]",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": null,
        "created_at": 1765163626.068701,
        "id": "65ed748a-5b9a-400a-b541-9186349aaae3",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1765163626.068727,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Client",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": true,
        "personal_room": "3369258f-5eb3-4d6f-9336-6ea43aae7019",
        "brand": null,
        "fake_email": null,
        "features": null,
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "current_time": "9:13 PM - Sunday Dec 07, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "[email protected] ",
        "abbreviated_display_name": "[email protected]",
        "online_state": "Offline",
        "has_password": false
      },
      {
        "type": "user",
        "username": null,
        "first_name": "",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": "+18598161689",
        "created_at": 1765163626.069971,
        "id": "76eed142-acf0-43cb-9009-fc0e234f72c0",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1765163626.069978,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Client",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": true,
        "personal_room": "8c16b1d1-1b37-4e25-9294-8de2af8d4017",
        "brand": null,
        "fake_email": true,
        "features": null,
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "current_time": "9:13 PM - Sunday Dec 07, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "+18598161689",
        "abbreviated_display_name": "+18598161689",
        "online_state": "Offline",
        "has_password": false
      },
      {
        "type": "user",
        "username": null,
        "first_name": "Unit",
        "last_name": "Test",
        "email": "[email protected]",
        "phone_number": "+4368120265807",
        "created_at": 1493115498.770362,
        "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1493115498.770744,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": true,
        "timezone": "America/Chicago",
        "user_type": "Admin",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": false,
        "personal_room": null,
        "brand": null,
        "fake_email": false,
        "features": [
          "Deals"
        ],
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "current_time": "9:13 PM - Sunday Dec 07, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "Unit Test",
        "abbreviated_display_name": "Unit",
        "online_state": "Offline",
        "has_password": true
      }
    ],
    "total_alerts": null,
    "total_favorites": null,
    "proposed_title": "[email protected], +18598161689"
  }
}

Add Users to a room

Add Users to a room
POST/rooms/{id}/users

You can add multiple users to a room in the same call

Example URI

POST /rooms/7c0c7439-baf5-4c0f-aaa1-134fceb44a26/users
URI Parameters
HideShow
id
string (required) Example: 7c0c7439-baf5-4c0f-aaa1-134fceb44a26
associations
string (required) Example: room.owner,room.latest_message,room.users
Request
HideShow
Body
{
  "users": [
    "41fa0991-132b-4482-979c-71625896e727"
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "type": "room",
    "id": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
    "title": "sampleroom",
    "owner": {
      "type": "user",
      "username": null,
      "first_name": "Unit",
      "last_name": "Test",
      "email": "[email protected]",
      "phone_number": "+4368120265807",
      "created_at": 1493115498.770362,
      "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "address_id": null,
      "cover_image_url": null,
      "profile_image_url": null,
      "updated_at": 1493115498.770744,
      "user_status": "Active",
      "profile_image_thumbnail_url": null,
      "cover_image_thumbnail_url": null,
      "email_confirmed": true,
      "timezone": "America/Chicago",
      "user_type": "Admin",
      "deleted_at": null,
      "phone_confirmed": false,
      "is_shadow": false,
      "personal_room": null,
      "brand": null,
      "fake_email": false,
      "features": [
        "Deals"
      ],
      "last_seen_at": null,
      "email_signature": null,
      "daily_enabled": false,
      "email_quota": 30000,
      "website": null,
      "instagram": null,
      "twitter": null,
      "linkedin": null,
      "youtube": null,
      "facebook": null,
      "designation": null,
      "tiktok": null,
      "mfa_enabled": false,
      "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "current_time": "9:13 PM - Sunday Dec 07, 2025",
      "push_allowed": true,
      "agents": null,
      "last_seen_type": null,
      "active_brand": null,
      "display_name": "Unit Test",
      "abbreviated_display_name": "Unit",
      "online_state": "Offline",
      "has_password": true
    },
    "created_at": 1765163626.204119,
    "updated_at": 1765163627.261771,
    "deleted_at": null,
    "room_type": "Group",
    "new_notifications": 0,
    "latest_message": {
      "type": "message",
      "mid": "a8215478-d076-47d7-b768-e60667434ccf",
      "id": "a8215478-d076-47d7-b768-e60667434ccf",
      "comment": "Unit invited John to join.",
      "image_url": null,
      "document_url": null,
      "video_url": null,
      "recommendation": null,
      "author": null,
      "created_at": 1765163627.261771,
      "updated_at": 1765163627.261772,
      "room": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
      "image_thumbnail_url": null,
      "deleted_at": null,
      "notification": {
        "type": "notification",
        "id": "5ae53dad-49e4-4498-bbc1-f80cc8e78db6",
        "object": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
        "message": "Unit invited John to join.",
        "created_at": 1765163627.250485,
        "updated_at": 1765163627.250485,
        "room": "7c0c7439-baf5-4c0f-aaa1-134fceb44a26",
        "action": "Invited",
        "object_class": "Room",
        "subject": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "auxiliary_object_class": "User",
        "auxiliary_object": {
          "type": "user",
          "username": null,
          "first_name": "John",
          "last_name": "Doe",
          "email": "[email protected]",
          "phone_number": "+989124834198",
          "created_at": 1765163625.905991,
          "id": "41fa0991-132b-4482-979c-71625896e727",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1765163625.906012,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": false,
          "timezone": "America/Chicago",
          "user_type": "Client",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": null,
          "personal_room": "08244ba3-3680-4af9-abaf-cae6c7e822a1",
          "brand": null,
          "fake_email": null,
          "features": null,
          "last_seen_at": null,
          "email_signature": "This is my signature.",
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": null,
          "current_time": "9:13 PM - Sunday Dec 07, 2025",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "John Doe",
          "abbreviated_display_name": "John",
          "online_state": "Offline",
          "has_password": true
        },
        "recommendation": null,
        "auxiliary_subject": null,
        "subject_class": "User",
        "auxiliary_subject_class": null,
        "extra_subject_class": null,
        "extra_object_class": null,
        "deleted_at": null,
        "specific": null,
        "title": null,
        "data": null,
        "sound": null,
        "app": "rechat",
        "transports": null,
        "phone_number": null,
        "notification_type": "UserInvitedRoom",
        "seen": true,
        "recommendations": null,
        "objects": null,
        "subjects": [
          {
            "type": "user",
            "username": null,
            "first_name": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "current_time": "9:13 PM - Sunday Dec 07, 2025",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "online_state": "Offline",
            "has_password": true
          }
        ]
      },
      "reference": null,
      "mentions": null,
      "activity": null,
      "role": null,
      "attachments": [],
      "files": null,
      "email_campaigns": null,
      "contacts": null,
      "crm_tasks": null,
      "compact_listings": null,
      "input_forms": null,
      "websites": null,
      "social_posts": null,
      "print_campaigns": null,
      "template_instances": null,
      "brand_assets": null,
      "acked_by": null,
      "deliveries": [
        {
          "user": "76eed142-acf0-43cb-9009-fc0e234f72c0",
          "delivery_type": "sms",
          "type": "notification_delivery",
          "created_at": "2025-12-08T03:13:47.464882+00:00"
        }
      ]
    },
    "notification_settings": {
      "80a227b2-29a0-11e7-b636-e4a7a08e15d4": "N_ALL"
    },
    "users": [
      {
        "type": "user",
        "username": null,
        "first_name": "John",
        "last_name": "Doe",
        "email": "[email protected]",
        "phone_number": "+989124834198",
        "created_at": 1765163625.905991,
        "id": "41fa0991-132b-4482-979c-71625896e727",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1765163625.906012,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Client",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": null,
        "personal_room": "08244ba3-3680-4af9-abaf-cae6c7e822a1",
        "brand": null,
        "fake_email": null,
        "features": null,
        "last_seen_at": null,
        "email_signature": "This is my signature.",
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "current_time": "9:13 PM - Sunday Dec 07, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "John Doe",
        "abbreviated_display_name": "John",
        "online_state": "Offline",
        "has_password": true
      },
      {
        "type": "user",
        "username": null,
        "first_name": "[email protected]",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": null,
        "created_at": 1765163626.068701,
        "id": "65ed748a-5b9a-400a-b541-9186349aaae3",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1765163626.068727,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Client",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": true,
        "personal_room": "3369258f-5eb3-4d6f-9336-6ea43aae7019",
        "brand": null,
        "fake_email": null,
        "features": null,
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "current_time": "9:13 PM - Sunday Dec 07, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "[email protected] ",
        "abbreviated_display_name": "[email protected]",
        "online_state": "Offline",
        "has_password": false
      },
      {
        "type": "user",
        "username": null,
        "first_name": "",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": "+18598161689",
        "created_at": 1765163626.069971,
        "id": "76eed142-acf0-43cb-9009-fc0e234f72c0",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1765163626.069978,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Client",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": true,
        "personal_room": "8c16b1d1-1b37-4e25-9294-8de2af8d4017",
        "brand": null,
        "fake_email": true,
        "features": null,
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "current_time": "9:13 PM - Sunday Dec 07, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "+18598161689",
        "abbreviated_display_name": "+18598161689",
        "online_state": "Offline",
        "has_password": false
      },
      {
        "type": "user",
        "username": null,
        "first_name": "Unit",
        "last_name": "Test",
        "email": "[email protected]",
        "phone_number": "+4368120265807",
        "created_at": 1493115498.770362,
        "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1493115498.770744,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": true,
        "timezone": "America/Chicago",
        "user_type": "Admin",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": false,
        "personal_room": null,
        "brand": null,
        "fake_email": false,
        "features": [
          "Deals"
        ],
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "current_time": "9:13 PM - Sunday Dec 07, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "Unit Test",
        "abbreviated_display_name": "Unit",
        "online_state": "Offline",
        "has_password": true
      }
    ],
    "total_alerts": null,
    "total_favorites": null,
    "proposed_title": "[email protected], +18598161689, John"
  }
}

Remove user from a room

Remove user from a room
DELETE/rooms/{rid}/users/{id}

Example URI

DELETE /rooms/7c0c7439-baf5-4c0f-aaa1-134fceb44a26/users/80a227b2-29a0-11e7-b636-e4a7a08e15d4
URI Parameters
HideShow
rid
string (required) Example: 7c0c7439-baf5-4c0f-aaa1-134fceb44a26
id
string (required) Example: 80a227b2-29a0-11e7-b636-e4a7a08e15d4
Response  204

Archive a room

Archive a room
DELETE/rooms/

Example URI

DELETE /rooms/

Generated by aglio on 08 Dec 2025