# CreateRealtimeTokenPayload (/api/reference/objects/create-realtime-token-payload)

A token to listen for live changes in the caller's workspace.

```graphql
type CreateRealtimeTokenPayload {
  channel: String!
  tokenRequest: String!
}
```

### Fields [#fields]

#### [`CreateRealtimeTokenPayload.channel`](#channel) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#channel]
The name of the channel to subscribe to: the workspace's own. A `candidate.updated` message on it carries `{ "candidateId": <id> }`.

#### [`CreateRealtimeTokenPayload.tokenRequest`](#token-request) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#token-request]
A signed Ably token request, as JSON text. Parse it and hand the object to the Ably client's `authCallback` unchanged. It works once and soon expires.

### Returned By [#returned-by]

[`createRealtimeToken`](/api/reference/mutations/create-realtime-token)  `mutation`