TikTok

Map a TikTok creator to a member

Maps a TikTok creator (from the unmatched list at GET /tiktok/orders) to an active member of the company. Mapping the same creator again, by handle or creator_user_id, replaces the earlier mapping. Later orders from the creator are credited to the member, and a background job moves the creator’s open orders on the connection (not yet shipped, cancelled or refunded) to the member when they carry house credit or no credit; an order with any other rep or attribution is never changed.

POST

api

v202506

tiktok

creator-mappings

Map a TikTok creator to a member

curl --request POST \
  --url https://api.fluid.app/api/v202506/tiktok/creator-mappings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "member_id": "0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90",
  "creator_handle": "@Creed-Bratton",
  "creator_user_id": "7493028561047391138",
  "connection_id": 3342
}
'

import requests

url = "https://api.fluid.app/api/v202506/tiktok/creator-mappings"

payload = {
    "member_id": "0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90",
    "creator_handle": "@Creed-Bratton",
    "creator_user_id": "7493028561047391138",
    "connection_id": 3342
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    member_id: '0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90',
    creator_handle: '@Creed-Bratton',
    creator_user_id: '7493028561047391138',
    connection_id: 3342
  })
};

fetch('https://api.fluid.app/api/v202506/tiktok/creator-mappings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/v202506/tiktok/creator-mappings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'member_id' => '0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90',
    'creator_handle' => '@Creed-Bratton',
    'creator_user_id' => '7493028561047391138',
    'connection_id' => 3342
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/v202506/tiktok/creator-mappings"

	payload := strings.NewReader("{\n  \"member_id\": \"0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90\",\n  \"creator_handle\": \"@Creed-Bratton\",\n  \"creator_user_id\": \"7493028561047391138\",\n  \"connection_id\": 3342\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/v202506/tiktok/creator-mappings")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"member_id\": \"0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90\",\n  \"creator_handle\": \"@Creed-Bratton\",\n  \"creator_user_id\": \"7493028561047391138\",\n  \"connection_id\": 3342\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/v202506/tiktok/creator-mappings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"member_id\": \"0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90\",\n  \"creator_handle\": \"@Creed-Bratton\",\n  \"creator_user_id\": \"7493028561047391138\",\n  \"connection_id\": 3342\n}"

response = http.request(request)
puts response.read_body

{
  "creator_mapping": {
    "id": 318,
    "creator_handle": "creed-bratton",
    "creator_user_id": "7493028561047391138",
    "member_id": "0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90",
    "created_at": "2026-10-20T16:42:11.000Z",
    "updated_at": "2026-10-20T16:42:11.000Z"
  },
  "status": 201,
  "meta": {
    "request_uuid": "8b4e2f71-3c9a-4d6e-b1f0-5a7c9e2d4b18",
    "timestamp": "2026-10-20T16:42:11Z"
  }
}

{
  "message": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 123,
      "prev_cursor": "<string>",
      "next_cursor": "<string>",
      "total_count": 123
    }
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 123,
      "prev_cursor": "<string>",
      "next_cursor": "<string>",
      "total_count": 123
    }
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 123,
      "prev_cursor": "<string>",
      "next_cursor": "<string>",
      "total_count": 123
    }
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 123,
      "prev_cursor": "<string>",
      "next_cursor": "<string>",
      "total_count": 123
    }
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

member_id

string<uuid>

required

Id of the active company member to credit.

creator_handle

string

required

The creator's TikTok handle; a leading @ and case are ignored.

connection_id

integer

Id of the company's TikTok connection to map the creator on. Omit it to use the primary connection (the oldest active one, or the most recent one when none is active).

Required range: x >= 1

creator_user_id

string | null

TikTok's stable creator_user_id, when known.

Response

Created

creator_mapping

object

An admin's mapping of one TikTok creator to a company member on the company's TikTok connection.

Show child attributes

status

integer

meta

object

Show child attributes

Map a TikTok creator to a member

curl --request POST \
  --url https://api.fluid.app/api/v202506/tiktok/creator-mappings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "member_id": "0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90",
  "creator_handle": "@Creed-Bratton",
  "creator_user_id": "7493028561047391138",
  "connection_id": 3342
}
'

import requests

url = "https://api.fluid.app/api/v202506/tiktok/creator-mappings"

payload = {
    "member_id": "0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90",
    "creator_handle": "@Creed-Bratton",
    "creator_user_id": "7493028561047391138",
    "connection_id": 3342
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    member_id: '0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90',
    creator_handle: '@Creed-Bratton',
    creator_user_id: '7493028561047391138',
    connection_id: 3342
  })
};

fetch('https://api.fluid.app/api/v202506/tiktok/creator-mappings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/v202506/tiktok/creator-mappings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'member_id' => '0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90',
    'creator_handle' => '@Creed-Bratton',
    'creator_user_id' => '7493028561047391138',
    'connection_id' => 3342
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/v202506/tiktok/creator-mappings"

	payload := strings.NewReader("{\n  \"member_id\": \"0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90\",\n  \"creator_handle\": \"@Creed-Bratton\",\n  \"creator_user_id\": \"7493028561047391138\",\n  \"connection_id\": 3342\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/v202506/tiktok/creator-mappings")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"member_id\": \"0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90\",\n  \"creator_handle\": \"@Creed-Bratton\",\n  \"creator_user_id\": \"7493028561047391138\",\n  \"connection_id\": 3342\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/v202506/tiktok/creator-mappings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"member_id\": \"0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90\",\n  \"creator_handle\": \"@Creed-Bratton\",\n  \"creator_user_id\": \"7493028561047391138\",\n  \"connection_id\": 3342\n}"

response = http.request(request)
puts response.read_body

{
  "creator_mapping": {
    "id": 318,
    "creator_handle": "creed-bratton",
    "creator_user_id": "7493028561047391138",
    "member_id": "0198f3a2-7c41-7d2e-9b5a-3e1f4a6c8d90",
    "created_at": "2026-10-20T16:42:11.000Z",
    "updated_at": "2026-10-20T16:42:11.000Z"
  },
  "status": 201,
  "meta": {
    "request_uuid": "8b4e2f71-3c9a-4d6e-b1f0-5a7c9e2d4b18",
    "timestamp": "2026-10-20T16:42:11Z"
  }
}

{
  "message": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 123,
      "prev_cursor": "<string>",
      "next_cursor": "<string>",
      "total_count": 123
    }
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 123,
      "prev_cursor": "<string>",
      "next_cursor": "<string>",
      "total_count": 123
    }
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 123,
      "prev_cursor": "<string>",
      "next_cursor": "<string>",
      "total_count": 123
    }
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 123,
      "prev_cursor": "<string>",
      "next_cursor": "<string>",
      "total_count": 123
    }
  }
}

Overview

Storefront

Commerce

Checkout

Member API

Messaging

People

Payments

DAM

Website

Portal

Mobile app

Content and tools

Analytics

Sales channels

Settings

FairShare SDK

Droplets

Developers

Unsorted endpoints

Portal & Widgets

Map a TikTok creator to a member

Authorizations

Body

Response