Start typing indicator
Start the typing indicator for a chat. The indicator shows the recipient that you are typing. Works for both 1:1 chats (pass a phone number or email as chatId) and group chats (pass the group ID, e.g. grp_...); in a group every participant sees the indicator.
RCS limitation: typing indicators are only delivered for iMessage chats — the RCS protocol does not carry composing state. Calls against RCS-routed chats return 200 with a warning field and have no visible effect on the recipient.
Authorization
BearerAuth API key authentication. Use your API key as the bearer token.
In: header
Path Parameters
Chat identifier. Can be: (1) phone number in E.164 format (e.g., +15551234567), (2) email address, (3) group ID (grp_xxxx), or (4) comma-separated list of phone numbers/emails for multi-recipient group chats (e.g., +15551234567,+15559876543). All values should be URL-encoded.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/chats/%2B15551234567/typing"{
"chat_id": "string",
"typing": true,
"started_at": 0,
"stopped_at": 0,
"warning": "RCS chats do not support composing indicators"
}{
"error": "string",
"message": "string",
"status": 0,
"code": "string"
}{
"error": "string",
"message": "string",
"status": 0,
"code": "string"
}{
"error": "string",
"message": "string",
"status": 0,
"code": "string"
}{
"error": "string",
"message": "string",
"status": 0,
"code": "string"
}