email_unsubscribe_sender
Asks a sender to stop, using the List-Unsubscribe link in their own mail. Requires Write on the account because it acts outside the mailbox on the user's behalf. Deletes nothing and moves nothing. Mail already in the mailbox stays where it is — follow this with email_bulk_modify_messages using query 'from:<address>' if the user wants it cleared too. Only https unsubscribe links are used; a mailto-only sender returns no_unsubscribe_url rather than quietly sending mail from the account. One-click (RFC 8058) is used when the sender advertises it. Read the result rather than assuming it worked: `success` false with a `reason` is a normal outcome, not an error. no_unsubscribe_url means the sender offers no link and the user should filter or block them instead; request_rejected means the endpoint refused. Tell the user which happened. Legitimate lists can also take a few days to take effect.
Input fields
{
"type": "object",
"properties": {
"account_id": {
"type": "string",
"minLength": 1,
"description": "The connected mailbox to act on, from email_accounts_list. Never guess this value and never reuse one across mailboxes — it selects both the credential and the permission set the call runs under."
},
"sender_email": {
"type": "string",
"minLength": 3,
"description": "The sender's address, exactly as it appears in email_senders_summary. Not a display name and not a domain."
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"description": "A unique value you generate for this attempt, e.g. a UUID. Retrying with the same key returns the original result instead of acting twice. Reusing a key with different arguments is an IDEMPOTENCY_CONFLICT."
}
},
"required": [
"account_id",
"sender_email",
"idempotency_key"
]
}Tool behavior
May change provider state. Check the explicit account, required access and provider capabilities before invoking.
Inspect isError and per-account errors. General write tools do not all enforce exact-plan approval. This reference does not certify any current AI client version.
YOUR INBOXES.
UNDER CONTROL.
Get started Start with a free account and one read-only search. Existing accounts keep their connection.