TikTok

Delete TikTok account

Remove one of the project's TikTok accounts. Its conversations and its customers' contacts are deleted, the agent stops replying on it, and member access to it is removed. Choose the account with inbox_id. The response is a boolean indicating whether the removal succeeded.

DELETE

https://api.nabrah.ai/api/ext/omni_v2/tiktok/inboxes

curl --request DELETE \
  --url 'https://api.nabrah.ai/api/ext/omni_v2/tiktok/inboxes' \
  --header 'X-API-Key: <your-api-key>'

false

Irreversible

Removing an account deletes its conversations and its customers' contacts. Connect it again from the platform to start over.

Agents

An agent that answered on the deleted account stays configured and keeps answering on its other accounts.

Use GET /api/ext/omni_v2/tiktok/inboxes to confirm which inbox(es) exist before deleting.

Choosing the TikTok account

A project can connect more than one TikTok account. inbox_id selects the account this call works on.

One account

inbox_id is optional; the project's only TikTok account is used.

More than one account

inbox_id is required and the call returns 400 without it. An id that is not one of the project's TikTok accounts returns 404.

inbox_id

List the accounts and their ids with GET /api/ext/omni_v2/tiktok/inboxes.

Authorization

X-API-Keystringheaderrequired

Your workspace API key. Create one in the dashboard under API keys.

Query parameters

inbox_idstring

The id of the TikTok account to use, from GET /api/ext/omni_v2/tiktok/inboxes.

Use inboxes[].id (a UUID), not the numeric inboxes[].inbox_id. Optional while the project has one TikTok account; required once it has more than one.

Response

200

Successful Response

application/json

422

Validation Error

application/json