pin_message
Pin a message to the top of a Signal DM or group chat so all participants can see it. Specify sender, timestamp, and recipient or group ID.
Instructions
Pin a message at the top of a DM or group conversation for all participants. Pinning is visible to everyone — don't use it as a private bookmark (send_note_to_self instead). Use unpin_message to remove a pin. target_author: E.164 number of the message's sender; target_timestamp: its ms timestamp (message id in get_conversation). Give recipient (E.164) for a DM or group_id for a group; neither is an error. Contacts Signal's servers; pinning an already pinned message changes nothing. Returns {status: 'message pinned'}.
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": {
"target_author": "<target_author>",
"target_timestamp": "<target_timestamp>"
},
"name": "pin_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| group_id | No | Group ID for group conversations — provide this OR recipient | |
| recipient | No | Phone number for DM conversations — provide this OR group_id | |
| target_author | Yes | Phone number of the message author (E.164) | |
| target_timestamp | Yes | Timestamp of the message to pin (from get_conversation) |