List the TikTok Business Account's direct-message conversations from the last 90 days

GET
/v1/content/tiktok.dm.threads

List the TikTok Business Account's direct-message conversations from the last 90 days.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

connectedProfileId*string

Koil Connected Profile associated with the operation.

Length1 <= length
variant*|

stranger: message requests the account has not replied to; single: conversations it has replied in.

cursor?string

Opaque cursor for fetching the next result page.

Length1 <= length
limit?number

Maximum number of items to return.

Range1 <= value
includeProviderRaw?boolean

Whether 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    }  }}