# WebSocket Client

> Connect to WebSocket servers through Postman Cloud Agent.

WebSocket Client is a client for connecting to WebSocket servers and inspecting bidirectional messages.

Also: online websocket client, websocket playground, websocket tester, wss client online, postman websocket client.

## What it does

Enter a WebSocket endpoint, configure query parameters, headers, and connection settings, then send text or binary messages through Postman.

## When to use it

- You want to test a public WebSocket endpoint.
- You need to inspect sent and received WebSocket messages.
- You want to troubleshoot a failed WebSocket handshake.

## What you give it

| Input | Meaning |
| --- | --- |
| WebSocket endpoint | The publicly accessible WebSocket server URL to connect to. |
| Message | Text, JSON, XML, HTML, Base64, or hexadecimal content. |
| Connection configuration | Query parameters, custom headers, and socket settings. |

## What you get back

| Output | Meaning |
| --- | --- |
| Message stream | A searchable timeline of sent, received, connection, and error events. |
| Handshake diagnostics | Connection errors and available WebSocket handshake details. |

## Key terms

- **WebSocket** — a persistent connection that supports messages in both directions.
- **Cloud Agent** — Postman infrastructure that executes connections for you.

## Questions

### Can the playground send binary messages?

Yes. Binary messages can be composed as Base64 or hexadecimal.

### Can I filter WebSocket messages?

Yes. Search all visible events or filter the stream to sent or received messages.

### Does the playground use variables?

No. It does not load workspace, collection, environment, cookie, history, or variable state.


## Privacy

Endpoint, headers, settings, and messages are sent to Postman Cloud Agent for execution. The playground does not load workspace or account data.

## Links

- [Use the tool](https://www.postman.com/tools/websocket-client) — the interactive version of this page.
- [Postman Tools](https://www.postman.com/tools) — every free tool in this set.
- [Guide to WebSocket requests](https://learning.postman.com/docs/sending-requests/websocket/websocket-overview/) — Postman documentation.
