update_call
Update call metadata: set notes, replace tags, toggle spam, change customer name, or lead status. Spam hides call; use add_call_tags for additive tags.
Instructions
Update an existing call: notes, tags, spam flag, customer name, lead status.
Args:
call_id: 'CAL...' id of the call to update.
account_id: Auto-resolves if omitted.
note: Replace the call's note text.
tags: REPLACE the call's tag list with this set of tag names.
(Use add_call_tags/remove_call_tags for additive changes.)
spam: True to mark as spam, False to unmark. Note: spam-flagged calls
are HIDDEN from default GET endpoints — re-reads will 404. Tag
the call BEFORE flagging spam if you need both.
customer_name: Override the auto-detected caller name.
lead_status: e.g. 'good_lead', 'not_a_lead', 'unknown'.
Note: value is intentionally NOT exposed here. CallRail's API returns
a 500 server error when value is included in the PUT body to /calls
(verified via live testing 2026-04-24). It IS supported on form
submissions — see update_form_submission.
Empty-string fields (e.g. note="") are rejected because CallRail
interprets them as "clear this field" — almost always a mistake.
To intentionally clear a field, set it to None and use a separate UI
operation, or contact CallRail support.
Length caps (rejected pre-network):
- note: 4000 chars
- customer_name: 200 chars
- tags: 100 entries max
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| call_id | Yes | ||
| account_id | No | ||
| note | No | ||
| tags | No | ||
| spam | No | ||
| customer_name | No | ||
| lead_status | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |