Partial Edit Responsible Person

POST

/product/202409/compliance/responsible_persons/{responsible_person_id}/partial_edit

Edit the details of an EU responsible person in the EU languages supported by TikTok Shop. Include the locale code to edit the responsible person’s information in a particular language. Target seller: Local sellers operating in EU countries Note:

• Updates are handled per top-level property, so all non-empty fields within an updated object must be supplied to prevent overwriting with blanks.
• For top-level properties (e.g. name, email) that are not nested in an object, you can update them individually. Omitting these properties in the request will leave them unchanged.
• If you need to edit any nested property within an object, you must provide values for all nested properties of that object. Any omitted nested properties will be overwritten with blanks. For example, if you want to update phone_number.local_number, you must also include the country_code property to avoid data loss for that property.

Authorizations

• accessToken

Parameters

Path Parameters

responsible_person_id

required

string

The responsible person ID in TikTok Shop.

Request Body

Media typeapplication/json

object

name

The responsible person name to update. Chinese characters are not supported when this field is provided. Max length: 200 characters

string

<= 200 characters

email

The email address of the responsible person to update. Chinese characters are not supported when this field is provided.

string

phone_number

The phone number of the responsible person to update. Chinese characters are not supported in local_number when this object is provided.

object

country_code

required

The country code of the phone number, prefixed by a plus + symbol. E.g. +353 for Ireland. Only EU country codes are allowed. Max digits: 4

string

local_number

required

The local number. Length: 7 - 11 digits

string

address

The residential address of the responsible person to update. Chinese characters are not supported in any supplied address field.

object

street_address_line1

required

The detailed street address of the location, including the building number, street name, district, city, province, and any relevant details. Max length: 500 characters

string

<= 500 characters

street_address_line2

(Deprecated: This field is deprecated and will be removed in a future API version. If provided, its value will be merged into street_address_line1. It is recommended to specify street_address_line1 directly.) An optional secondary line for additional address details, if necessary. Max length: 500 characters

string

<= 500 characters

district

(Deprecated: This field is deprecated and will be removed in a future API version. If provided, its value will be merged into street_address_line1. It is recommended to specify street_address_line1 directly.)

The district name. Max length: 500 characters

string

<= 500 characters

city

(Deprecated: This field is deprecated and will be removed in a future API version. If provided, its value will be merged into street_address_line1. It is recommended to specify street_address_line1 directly.)

The city name. Max length: 500 characters

string

<= 500 characters

postal_code

required

The postal code. Max length: 500 characters

string

<= 500 characters

province

(Deprecated: This field is deprecated and will be removed in a future API version. If provided, its value will be merged into street_address_line1. It is recommended to specify street_address_line1 directly.)

The province, state, or region name. Max length: 500 characters

string

<= 500 characters

country

required

The two letter ISO 3166 country code representing the country of the address. It must be an EU country.

string

locale

The BCP-47 locale code representing the language of the responsible person information to update. Possible values:

• de-DE
• en-IE
• es-ES
• fr-FR
• it-IT Default: The locale of the seller’s registered business address.

Note: Only the language version selected by this locale is updated; other language versions remain unchanged. Ensure the locale matches the language used in the supplied field values.

string

Allowed values: de-DE en-IE es-ES fr-FR it-IT

Example

{
  "name": "John Doe",
  "email": "john.doe@email.com",
  "phone_number": {
    "country_code": "+353",
    "local_number": "80915151"
  },
  "address": {
    "street_address_line1": "63 Cardiff Ln, Grand Canal Dock, Dublin City, Dublin",
    "street_address_line2": "-",
    "district": "-",
    "city": "-",
    "postal_code": "D02 HD23",
    "province": "-",
    "country": "IE"
  },
  "locale": "en-IE"
}

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

Example

{
  "code": 0,
  "data": {},
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}