{"info":{"_postman_id":"c92bb5d1-c004-4c33-a546-2c8250c96bb2","name":"convohub","description":"

StartFragment

This API powers ConvoHub — a real-time chat application supporting instant messaging, one-to-one chat, and group conversations.

Core Features:
• User authentication with JWT
• One-to-one and group chat creation
• Real-time messaging via Socket.io
• Message read receipts
• Online/offline user status
• Secure protected routes

Base URL: https://www.convohub.in/

EndFragment

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"39216531","collectionId":"c92bb5d1-c004-4c33-a546-2c8250c96bb2","publishedId":"2sBXc8nhpT","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-02-05T05:43:49.000Z"},"item":[{"name":"Signup","id":"2a4ba138-4711-492d-8efa-8237e8e5ec8b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"name\": \"Kiran Chaudhary\",\r\n \"email\": \"kiran@example.com\",\r\n \"password\": \"password123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/auth/signup","description":"

StartFragment

Registers a new user account in ConvoHub.

This endpoint creates a user using name, email, and password.
Password is securely hashed before storing in the database.

✅ Use this before login
✅ Returns user info + authentication token

EndFragment

\n","urlObject":{"protocol":"http","port":"5000","path":["api","auth","signup"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"2a4ba138-4711-492d-8efa-8237e8e5ec8b"},{"name":"signup-second user","id":"f3589a29-937b-4c12-8b07-f2835a232d8d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"name\": \"Priya Singh\",\r\n \"email\": \"priya@example.com\",\r\n \"password\": \"password123\"\r\n}"},"url":"http://localhost:5000/api/auth/signup","description":"

StartFragment

Registers a new user account in ConvoHub.

This endpoint creates a user using name, email, and password.
Password is securely hashed before storing in the database.

✅ Use this before login
✅ Returns user info + authentication token

Required fields:

name — user full name
\n
email — unique email address
\n
password — minimum 6 characters
\n

EndFragment

\n","urlObject":{"protocol":"http","port":"5000","path":["api","auth","signup"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"f3589a29-937b-4c12-8b07-f2835a232d8d"},{"name":"Login","id":"a51cec48-5a1f-4ada-aa00-18df26597cea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"kiran@example.com\",\r\n \"password\": \"password123\"\r\n}"},"url":"http://localhost:5000/api/auth/login","description":"

StartFragment

Authenticates an existing user and returns a JWT token.

Use registered email and password to log in.
On success, server returns user data and access token.

✅ Token must be used in Authorization header for protected routes
Header format:
Authorization: Bearer

EndFragment

\n","urlObject":{"protocol":"http","port":"5000","path":["api","auth","login"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"a51cec48-5a1f-4ada-aa00-18df26597cea"},{"name":"get user","id":"e6351959-ebff-4098-ad14-ab3ebd7403e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"kiran@example.com\",\r\n \"password\": \"password123\"\r\n}"},"url":"http://localhost:5000/api/users","description":"

StartFragment

Fetches the list of all registered users.

Used to show available users for one-to-one chat creation and group member selection.

🔐 Protected route — requires Bearer token
Returns user list with basic profile info

EndFragment

\n","urlObject":{"protocol":"http","port":"5000","path":["api","users"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"e6351959-ebff-4098-ad14-ab3ebd7403e7"},{"name":"chat-one to one","id":"acb8257b-4fc6-4029-9c8c-97f4d047d096","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"recipientId\": \"697f223c34ea794e4266371a\"\r\n}"},"url":"http://localhost:5000/api/chats/one-to-one","description":"

StartFragment

Creates (or fetches if already exists) a one-to-one chat between two users.

Provide recipientId of the target user.
If chat already exists → returns existing chat
Else → creates new chat

Used when user clicks “Start Chat”.

🔐 Protected route

EndFragment

\n","urlObject":{"protocol":"http","port":"5000","path":["api","chats","one-to-one"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"acb8257b-4fc6-4029-9c8c-97f4d047d096"},{"name":"message","id":"65778d49-6dfe-4e23-a8d2-77d5caf8f7ef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"chatId\": \"697f231e34ea794e42663724\",\r\n \"text\": \"Hello Priya! 🎉\"\r\n}"},"url":"http://localhost:5000/api/messages","description":"

StartFragment

Sends a new message to a specific chat.

Creates message record and triggers real-time socket event.

Fields:

chatId — target chat
\n
text — message content
\n

Used when user sends message in chat window.

🔐 Protected route
⚡ Emits real-time event via socket

EndFragment

\n","urlObject":{"protocol":"http","port":"5000","path":["api","messages"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"65778d49-6dfe-4e23-a8d2-77d5caf8f7ef"},{"name":"message-id","id":"a6f51ed9-93a7-4ed9-aee6-6689a158fd66","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"chatId\": \"697f231e34ea794e42663724\",\r\n \"text\": \"Hello Priya! 🎉\"\r\n}"},"url":"http://localhost:5000/api/messages/697f231e34ea794e42663724","description":"

StartFragment

Fetches all messages for a specific chat.

Used when opening a chat window to load message history.

Returns messages sorted by time.

🔐 Protected route

EndFragment

\n","urlObject":{"protocol":"http","port":"5000","path":["api","messages","697f231e34ea794e42663724"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"a6f51ed9-93a7-4ed9-aee6-6689a158fd66"},{"name":"message mark-seen","id":"70408d15-16b5-43d0-8c5e-c1a526d34065","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"PUT","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"chatId\": \"697f231e34ea794e42663724\",\r\n \"text\": \"Hello Priya! 🎉\"\r\n}"},"url":"http://localhost:5000/api/messages/697f23a034ea794e42663729/mark-seen","description":"

StartFragment

Marks a specific message as seen/read.

Updates read status and triggers real-time seen update event.

Used for read receipts feature.

🔐 Protected route
⚡ Emits socket event

EndFragment

\n","urlObject":{"protocol":"http","port":"5000","path":["api","messages","697f23a034ea794e42663729","mark-seen"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"70408d15-16b5-43d0-8c5e-c1a526d34065"},{"name":"group","id":"4c692d79-895c-4ae1-a91e-b7bf6d2296c2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"name\": \"Friends Group\",\r\n \"memberIds\": [\"697f223c34ea794e4266371a\"]\r\n}"},"url":"http://localhost:5000/api/chats/group","description":"

StartFragment

Creates a new group chat with multiple members.

Request body includes:

name — group name
\n
memberIds — array of user IDs
\n

Creator becomes group admin by default.

Used for group conversations.

🔐 Protected route

EndFragment

\n","urlObject":{"protocol":"http","port":"5000","path":["api","chats","group"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"4c692d79-895c-4ae1-a91e-b7bf6d2296c2"},{"name":"New Request","id":"df197b7e-17a2-480c-8b8c-5c2ba75d4e41","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"urlObject":{"query":[],"variable":[]},"url":""},"response":[],"_postman_id":"df197b7e-17a2-480c-8b8c-5c2ba75d4e41"}]}