Skip to main content

Match Account Script Configuration

This page documents the configuration parameters for the match_account script used in task creation.

Overview​

The match_account script is used to automatically match and synchronize TikTok, Instagram or Threads accounts logged in on a device with TikMatrix's account database. It scans the accounts currently logged into the app on the device and updates the account status in TikMatrix accordingly.

Use Case

This script is useful when you have manually logged into accounts on a device and want TikMatrix to recognize and manage those accounts. Run this script once per device after logging in to new accounts.

Threads

Supported. The script reads every profile from the app's Settings → Switch accounts sheet, which lists them all at once, so one pass covers the device.

Threads signs in with Instagram accounts, so the same handle is often a real Instagram handle too. Matching Threads only ever touches your Threads accounts — an Instagram account of the same name is left exactly as it was.

Script Configuration (script_config)​

The match_account script does not require any configuration parameters. You can pass an empty object.

Parameters​

ParameterTypeRequiredDefaultDescription
(none)—No—This script takes no configuration parameters

Examples​

Match Accounts on a Single Device​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "match_account",
    "script_config": {}
  }'

Match Accounts on Multiple Devices​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1", "device_serial_2", "device_serial_3"],
    "script_name": "match_account",
    "script_config": {}
  }'

Schedule Match Account Task​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "match_account",
    "script_config": {},
    "start_time": "08:00"
  }'

Response​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [501],
    "created_count": 1
  }
}

Error Codes​

CodeDescription
40001Missing required parameters (serials or usernames)
40003Script not supported via API
40301API access requires Pro+ plan

See Also​