Edit a company contact
editCompanyContactCreate, change or deactivate a company contact. create: needs firstName + email; email is unique per company. Optional lastName, phone, linkedinUrl, title, calendarLink, isPrimary, shouldCc, slackTagging. Re-adding a removed email reactivates it. update: contactId + any fields to change. timezone takes an IANA zone like Europe/Berlin, null to clear. delete: contactId. Deactivates the contact (soft delete). set_primary: contactId. Makes it the company's primary contact. set_active: contactId + active. Reactivate (true) or deactivate (false). Ids come from readCompanyContacts list. calendarLink decides whose calendar the hiring manager's interview books on, so keep it correct. A role that needs its own link (a different link per role) takes it on the job tool's update calendarLink, not on a second contact.
Clera privately records this tool's inputs and results for usage tracking and support.
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": {
"command": "<command>"
},
"name": "editCompanyContact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| No | create (required) / update: contact's email (unique per company) | ||
| orgId | No | Organization to act as. Only needed when you belong to more than one organization. | |
| phone | No | create/update: phone number | |
| title | No | create/update: job title at the company | |
| active | No | set_active (required): true reactivates, false deactivates | |
| command | Yes | Which operation to run: create | update | delete | set_primary | set_active. The tool description explains each. | |
| lastName | No | create/update: contact's last name | |
| shouldCc | No | create/update: whether to CC this contact on emails | |
| timezone | No | update: the contact's IANA timezone like Europe/Berlin, null to clear; times in their emails use it | |
| contactId | No | get/update/delete/set_primary/set_active (required): the contact's id from list | |
| firstName | No | create (required) / update: contact's first name | |
| isPrimary | No | create/update: mark as the primary company contact | |
| linkedinUrl | No | create/update: LinkedIn profile URL | |
| calendarLink | No | create/update: calendar/scheduling link | |
| slackTagging | No | create/update: who Clera @-mentions on candidates and lists in the company's Slack channel. own_roles (default): tagged on roles they're hiring manager on; roles with no hiring manager go to the primary contact, or the earliest-added contact when none is primary. every_role: tagged on every candidate and list. never: never tagged, only named in plain text on their own roles. Set never when someone asks to stop being tagged. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| command | Yes | ||
| contact | No | ||
| contacts | No | ||
| contactId | No |