Pin a subscriber's location
pin_subscriber_locationPin a subscriber's location to set city, region, country, coordinates, and timezone. Requires confirm=true because it may alter delivery and audience membership.
Instructions
Pin a subscriber's location. May affect delivery, audience membership, published data or irreversible state. Requires confirm=true.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"subscriber_id": "<subscriber_id>"
},
"name": "pin_subscriber_location"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | Named private account from KIT_ACCOUNTS. Defaults to KIT_DEFAULT_ACCOUNT or the first configured account. | |
| confirm | No | Set true only when the user asked for exactly this action. | |
| payload | No | Complete JSON body instead of individual body flags. Supports nullable fields and nested bulk structures. Cannot be combined with body flags or payload_file. | |
| location | No | ||
| payload_file | No | Local JSON request body file, at most 5 MB. Contents are validated before the API call and are never logged. | |
| subscriber_id | Yes | Positive subscriber id. |