Close CRM: Close Update Contact

Update an existing person contact in Close CRM by id: change their name, job title, email addresses, phone numbers or custom fields.

Tool ID: close_update_contact

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'close_update_contact',
  {
    "id": "id_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline run close_update_contact --input '{
  "id": "id_123"
}'

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "created_by": "example",
    "date_created": "2026-01-15T12:00:00Z",
    "date_updated": "2026-01-15T12:00:00Z"
  }
}

Use deepline describe close_update_contact --json for the latest machine-readable contract.

Input reference

Change an existing Close CRM contact by id. Send only fields to change. omitted fields remain unchanged. Supply the complete email, phone and URL lists you intend to store. Changing lead_id moves the contact to another company lead. This writes CRM data. Recover an uncertain execution before repeating it.

Name	Type	Required	Default	Details
`payload.id`	`string`	Yes	—	—
`payload._fields`	`string`	No	—	Comma-separated list of fields to include in the response.
`payload.emails`	`array`	No	—	Maximum items: 100.
`payload.lead_id`	`string`	No	—	—
`payload.name`	`string`	No	—	Maximum length: 1000.
`payload.phones`	`array`	No	—	Maximum items: 100.
`payload.timezone`	`string`	No	—	IANA timezone identifier
`payload.title`	`string`	No	—	Maximum length: 1000.
`payload.urls`	`array`	No	—	Maximum items: 100.
`payload.custom_fields`	`record`	No	—	Map Close custom field ids (cf_…) to values. null clears a value. Add .add or .remove to a field id to modify a multi-value field.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.created_by`	`string \| null`	No	—	—
`result.data.date_created`	`string`	No	—	Format: `date-time`.
`result.data.date_updated`	`string`	No	—	Format: `date-time`.
`result.data.display_name`	`string`	No	—	—
`result.data.emails`	`array`	No	—	—
`result.data.emails[].email`	`string`	Yes	—	—
`result.data.emails[].is_unsubscribed`	`boolean`	Yes	—	—
`result.data.emails[].type`	`string`	Yes	—	—
`result.data.id`	`string`	No	—	—
`result.data.integration_links`	`array`	No	—	—
`result.data.integration_links[].name`	`string`	Yes	—	—
`result.data.integration_links[].url`	`string`	Yes	—	—
`result.data.lead_id`	`string \| null`	No	—	—
`result.data.lead_suggestions_operation_id`	`string \| null`	No	—	—
`result.data.name`	`string \| null`	No	—	—
`result.data.organization_id`	`string`	No	—	—
`result.data.phones`	`array`	No	—	—
`result.data.phones[].country`	`string \| null`	No	—	—
`result.data.phones[].outbound_sms_blocked`	`boolean`	No	—	—
`result.data.phones[].phone`	`string`	Yes	—	—
`result.data.phones[].phone_formatted`	`string`	No	—	—
`result.data.phones[].type`	`string`	Yes	—	—
`result.data.phones[].tz_ids`	`array`	No	—	—
`result.data.recent_calls`	`array`	No	—	—
`result.data.recent_calls[].dialer_id`	`string \| null`	Yes	—	—
`result.data.recent_calls[].duration`	`integer`	Yes	—	—
`result.data.recent_calls[].finish_timestamp`	`string`	Yes	—	Format: `date-time`.
`result.data.recent_calls[].id`	`string`	Yes	—	—
`result.data.recent_calls[].status`	`"created" \| "in-progress" \| "completed" \| "cancel" \| "no-answer" \| "busy" \| "failed" \| "timeout"`	Yes	—	Current status of the call. Allowed: `created`, `in-progress`, `completed`, `cancel`, `no-answer`, `busy`, `failed`, `timeout`.
`result.data.subscriptions`	`array`	No	—	—
`result.data.subscriptions[].contact_email`	`string \| null`	Yes	—	—
`result.data.subscriptions[].date_created`	`string`	Yes	—	Format: `date-time`.
`result.data.subscriptions[].initial_email_id`	`string \| null`	Yes	—	—
`result.data.subscriptions[].sequence_id`	`string`	Yes	—	—
`result.data.subscriptions[].sequence_name`	`string`	Yes	—	—
`result.data.subscriptions[].sequence_status`	`"active" \| "paused" \| "draft"`	Yes	—	Allowed: `active`, `paused`, `draft`.
`result.data.subscriptions[].start_date`	`string \| null`	Yes	—	Format: `date-time`.
`result.data.subscriptions[].subscription_id`	`string`	Yes	—	—
`result.data.subscriptions[].subscription_status`	`"active" \| "paused" \| "finished" \| "goal" \| "error"`	Yes	—	Allowed: `active`, `paused`, `finished`, `goal`, `error`.
`result.data.subscriptions[].subscription_status_reason`	"manual" \| "pending-call-timed-out" \| "bulk-action" \| "rate-limited" \| "sequence-deleted" \| "workflow-paused" \| "filter-not-matched" \| "insufficient-ai-credit-balance" \| "plan-not-supported" \| "reply-received" \| "call-answered" \| "meeting-booked" \| "lead-status-changed" \| "outcome-met" \| "account-invalid" \| "account-failures" \| "sending-throttled-too-long" \| "membership-inactive" \| "send-as-error" \| "email-bounced" \| "call-failed" \| "sms-failed" \| "no-user-phone" \| "billing-error" \| "assignment-field-invalid" \| "lead-status-field-invalid" \| "assignees-missing" \| "run-as-disabled" \| "lead-not-visible" \| "internal-error" \| "field-mapping-error" \| "filter-config-invalid" \| "email-ai-generation-failed"	Yes	—	Reason for each higher level status on a Workflow run. Allowed: `manual`, `pending-call-timed-out`, `bulk-action`, `rate-limited`, `sequence-deleted`, `workflow-paused`, `filter-not-matched`, `insufficient-ai-credit-balance`, `plan-not-supported`, `reply-received`, `call-answered`, `meeting-booked`, `lead-status-changed`, `outcome-met`, `account-invalid`, `account-failures`, `sending-throttled-too-long`, `membership-inactive`, `send-as-error`, `email-bounced`, `call-failed`, `sms-failed`, See the live schema for the complete constraint.
`result.data.timezone`	`string \| null`	No	—	—
`result.data.timezone_source`	`string \| null`	No	—	—
`result.data.title`	`string \| null`	No	—	—
`result.data.updated_by`	`string \| null`	No	—	—
`result.data.urls`	`array`	No	—	—
`result.data.urls[].type`	`string`	Yes	—	—
`result.data.urls[].url`	`string`	Yes	—	—
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation