All systems normalDashboardGet an API key
API reference / Connected sessions / Typing indicator

Typing indicator

Send a live typing indicator in a conversation.

POSTapi.tikultra.com/v1/account/dm/typing15 credits
Upstream
/im/v1/message/send
Access
Growth and up
Runs on
FullPool
Billing
Failed calls are free

Authorization & parameters

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Body

Send JSON with content-type: application/json.

account_idstringrequired

A connected account, from /dash/sessions or POST /v1/account/import. For example acc_7Hq2.

conversation_idstringrequired

The conversation. For example 0:1:6970000000000000001:6970000000000000002.

conversation_short_idstring

Optional short conversation ID. For example 7410889900112233445.

Client and egress

Executes on the dedicated FullPool mobile context and city-level egress bound to account_id. See Connected sessions.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Response fields

Key top-level and nested fields decoded from the mobile upstream payload:

status_codeinteger

Upstream TikTok mobile status code (0 indicates success).

account_idstring

Connected session identifier bound to a dedicated FullPool mobile context.

conversation_idstring

Full mobile IM conversation identifier.

conversation_short_idstring

Numeric 64-bit short conversation ID used by IM wire calls.

typing_dispatchedboolean

Whether typing dispatched is enabled or true.

ttl_msinteger

Ttl in milliseconds.

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.

Accounts you own only. Connected sessions are for accounts you own or are authorized to operate. Available on Growth and Scale.