List the TikTok Business Account's direct-message conversations from the last 90 days
List the TikTok Business Account's direct-message conversations from the last 90 days.
Authorization
bearerAuth In: header
Query Parameters
Koil Connected Profile associated with the operation.
1 <= lengthstranger: message requests the account has not replied to; single: conversations it has replied in.
Opaque cursor for fetching the next result page.
1 <= lengthMaximum number of items to return.
1 <= valueWhether to include transient provider-native payloads.
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/content/tiktok.dm.threads?connectedProfileId=string&variant=stranger"{ "data": [ { "externalId": "string", "variant": "stranger", "updatedAt": "2019-08-24T14:15:22Z", "referral": { "source": "ad", "ads": [ { "advertiserId": "string", "adId": "string", "adName": "string", "embedUrl": "string", "materialId": "string", "referredAt": "2019-08-24T14:15:22Z" } ], "shortLinks": [ { "ref": "string", "prefilledMessage": "string", "prefilledMessageAuditStatus": "PASS" } ] }, "lastReadAt": "2019-08-24T14:15:22Z", "providerRaw": null, "contentType": "tiktok.dm.threads" } ], "nextCursor": "string", "hasMore": true}{ "error": { "code": "validation_error", "message": "string", "meta": { "property1": null, "property2": null } }}Get one mention in full, hydrating a mention event GET
Get one mention in full, hydrating a mention event: TikTok's webhook payload carries no engagement counts or thumbnail, and no comment text or author handle for a comment mention. Details stay readable for 48 hours after the webhook.
List the 20 most recent messages of one TikTok direct-message conversation GET
List the 20 most recent messages of one TikTok direct-message conversation.