Synup
View MCP connections
MCPMCP Tools/Clients/update_client

update_client

Writeclients:write

Edit an existing client's editable fields. Pass only the fields you want to change. The client's primaryContactEmail (their portal login) can never be changed here. Identify the client by its id (from list_clients, create_client, or — for an archived client, which list_clients and get_client_by_id never return — the id create_client's duplicate_archived error names). Works on an archived client too, without reactivating it first. Returns the updated client, or throws if not found. You don't pass an agency — it comes from your credentials.

Parameters
clientIdstringrequired
The id of the client to update (required).
businessNamestringoptional
The client's business name.
industrystringoptional
The client's business category or industry.
websitestringoptional
The client's website URL. A short link (e.g. a URL shortener) is auto-expanded to its real destination before it's stored.
primaryContactNamestringoptional
The primary contact's name.
phonestringoptional
The client's phone number.
locationCountnumberoptional
The client's reported location count (informational — not the actual count of created locations).
citystringoptional
The client's city.
phoneCountryCodestringoptional
The ISO-3166-1 alpha-2 country code the client's phone number belongs to (e.g. "US", "IN") — the region, not the dial code.
countrystringoptional
The client's country, as an ISO-3166-1 alpha-2 code (e.g. "US", "GB").
statestringoptional
The client's state, province or region.
trackingKeywordstringoptional
A keyword to track the client's local search rank for.
notesstringoptional
An internal note about the client — visible only to your team, never to the client.
gbpLinkstringoptional
The client's Google Business Profile URL. A scheme (https://) is added automatically if you omit it.
clientPlanIdstringoptional
Which customer-portal plan to assign. There's currently no tool to look up other plan ids — omit to leave the client's current plan unchanged.
primaryRepresentativeIdstringoptional
The user id of the team member who owns this client (from list_team_members).
visibility"public" | "private"optional
Who can see this client on the dashboard: "public" (the whole team) or "private" (owners always still see it; every other member needs an explicit access grant that no tool currently exists to give). Switching an existing client to "private" immediately hides it from every non-owner member who doesn't already hold one — there is no way to grant individual members access back through MCP, only to switch it back to "public".
Example request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_client",
    "arguments": {
      "clientId": "string"
    }
  }
}
Example response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

Response shape shown for illustration — the actual content depends on the tool and your data.