Updates: Check the release notes for new features and product updates.

Method: phones.capability.requestCapabilityCallback

Requests a callback containing the capabilities of a user.

Following this request, the agent receives an asynchronous callback with the user's capabilities.

HTTP request

POST https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*}/capability:requestCapabilityCallback

The URL uses gRPC Transcoding syntax.

Path parameters



"phones/{E.164}/capability", where {E.164} is the user's phone number in E.164 format. For example, with the US phone number +1-222-333-4444, the resulting endpoint would be https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capability:requestCapabilityCallback

Request body

The request body contains data with the following structure:

JSON representation
  "requestId": string


The ID of the request, assigned by the agent. This must be a UUID, as defined in https://tools.ietf.org/html/rfc4122. This request ID is included in the capability callback, which returns asynchronously.

Response body

If successful, the response body will be empty.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

For more information, see the OAuth 2.0 Overview.