# createRealtimeToken (/api/reference/mutations/create-realtime-token)

Get a token to listen for live changes in the caller's workspace. The token allows subscribing to that workspace's channel and nothing else, with the caller as its client id. Ask for a new one each time the realtime client renews: every call makes a new token, so the answer must never be cached. `NOT_CONFIGURED` with `service: REALTIME` where realtime is switched off, and the app then falls back to polling.

```graphql
createRealtimeToken: CreateRealtimeTokenPayload!
```

### Type [#type]

#### [`CreateRealtimeTokenPayload`](/api/reference/objects/create-realtime-token-payload) `object` [#createrealtimetokenpayload-object]
A token to listen for live changes in the caller's workspace.