Close CRM: Close Create Contact

Add a new person to a Close company: create a contact with known email and phone, name and job title.

Tool ID: close_create_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_create_contact',
  {
    "_fields": "example",
    "created_by": null,
    "date_created": "2026-01-15T12:00:00Z"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline run close_create_contact --input '{
  "_fields": "example",
  "created_by": null,
  "date_created": "2026-01-15T12:00:00Z"
}'

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_create_contact --json for the latest machine-readable contract.

Input reference

Create a new Close CRM contact. Supply lead_id to attach the person to an existing company. omitting it also creates a new lead named after the contact. Email, phone and URL fields are arrays. This creates CRM records and can create duplicates if repeated. Use a stable Deepline execution key to recover an uncertain outcome before starting another write.

Name	Type	Required	Default	Details
`payload._fields`	`string`	No	—	Comma-separated list of fields to include in the response.
`payload.created_by`	`string`	No	—	—
`payload.date_created`	`string`	No	—	Format: `date-time`.
`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.

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