---
title: "Set a typing indicator"
method: POST
path: "/api/v1/typing"
tags: ["messages"]
---

# Set a typing indicator

`POST /api/v1/typing`

Starts or stops a typing indicator shown to the recipient, as if someone
were composing a message from your number.

**iMessage numbers show it; standard (SMS) numbers ignore it.** SMS has
no typing concept, so for a standard from-number the request succeeds and
does nothing — the response is identical either way, letting you call
this unconditionally before a send.

The indicator is fire-and-forget: nothing is persisted and no event is
emitted. Delivering a message or reaction from the same number
**clears the indicator natively** on the recipient's device — platform
behavior, not Dial's; start again after a send if you're still
composing. Dial itself never clears it: send `value: false` when you
stop composing without sending. (A stale indicator may also clear on
its own device-side.) Free of charge.

## Headers

- `Authorization` string, required

## Request body

- object
  - `toNumber` string, required — Recipient phone number in E.164 format.
  - `value` boolean, required — `true` shows the typing indicator; `false` clears it.
  - `fromNumber` string, required — The Dial number the indicator appears from, referenced flexibly: a phone-number ID, one of your numbers in E.164 format, or a number's nickname. A nickname shared by more than one of your numbers is rejected with `400`; a ref that matches none of your numbers returns `404`.

## Response `200`

Indicator set (or silently ignored for a from-number without typing support).

- MessagesSendTypingResponse200
  - `ok` boolean

## Other responses

- `400` — The request body failed validation.
- `401` — Missing or invalid API key.
- `404` — The requested resource was not found on this account.

---

[API](https://skmtc.net/getdial/apis/rest-api.md) · [All operations](https://skmtc.net/getdial/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getdial/rest-api/revisions/5f4eb30ac29a/schema)