Close CRM: Close Create Lead

Add a company to Close CRM: create a new lead with its website, description, address, custom fields and lead status.

Tool ID: close_create_lead

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_lead',
  {
    "name": "Example",
    "description": "Example description",
    "url": "https://example.com"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline run close_create_lead --input '{
  "name": "Example",
  "description": "Example description",
  "url": "https://example.com"
}'

Example response

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

{
  "data": {
    "addresses": [
      {
        "address_1": "example",
        "address_2": "example",
        "city": "San Francisco",
        "country": "US",
        "label": "example",
        "state": "California",
        "zipcode": "example"
      }
    ],
    "contact_ids": [
      "contact_123"
    ],
    "contacts": [
      {
        "created_by": "example",
        "date_created": "2026-01-15T12:00:00Z",
        "date_updated": "2026-01-15T12:00:00Z"
      }
    ]
  }
}

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

Input reference

Create a new Close CRM lead (company or organization). Supply the company fields to store. choose either status or status_id, never both. Omitting status uses the Close default. This creates CRM data and can create duplicates if repeated. Add contacts separately with close_create_contact. Use a stable Deepline execution key to recover an uncertain outcome before starting another write.

Name	Type	Required	Default	Details
`payload.name`	`string`	No	—	—
`payload.description`	`string`	No	—	—
`payload.url`	`string`	No	—	—
`payload.status`	`string`	No	—	—
`payload.status_id`	`string`	No	—	—
`payload.addresses`	`array`	No	—	—
`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.addresses`	`array`	No	—	—
`result.data.addresses[].address_1`	`string \| null`	Yes	—	—
`result.data.addresses[].address_2`	`string \| null`	Yes	—	—
`result.data.addresses[].city`	`string \| null`	Yes	—	—
`result.data.addresses[].country`	`string \| null`	Yes	—	—
`result.data.addresses[].label`	`string \| null`	Yes	—	—
`result.data.addresses[].state`	`string \| null`	Yes	—	—
`result.data.addresses[].tz_ids`	`array`	No	—	—
`result.data.addresses[].zipcode`	`string \| null`	Yes	—	—
`result.data.contact_ids`	`array`	No	—	—
`result.data.contacts`	`array`	No	—	—
`result.data.contacts[].created_by`	`string \| null`	No	—	—
`result.data.contacts[].date_created`	`string`	No	—	Format: `date-time`.
`result.data.contacts[].date_updated`	`string`	No	—	Format: `date-time`.
`result.data.contacts[].display_name`	`string`	No	—	—
`result.data.contacts[].emails`	`array`	No	—	—
`result.data.contacts[].emails[].email`	`string`	Yes	—	—
`result.data.contacts[].emails[].is_unsubscribed`	`boolean`	Yes	—	—
`result.data.contacts[].emails[].type`	`string`	Yes	—	—
`result.data.contacts[].id`	`string`	No	—	—
`result.data.contacts[].integration_links`	`array`	No	—	—
`result.data.contacts[].integration_links[].name`	`string`	Yes	—	—
`result.data.contacts[].integration_links[].url`	`string`	Yes	—	—
`result.data.contacts[].lead_id`	`string \| null`	No	—	—
`result.data.contacts[].lead_suggestions_operation_id`	`string \| null`	No	—	—
`result.data.contacts[].name`	`string \| null`	No	—	—
`result.data.contacts[].organization_id`	`string`	No	—	—
`result.data.contacts[].phones`	`array`	No	—	—
`result.data.contacts[].phones[].country`	`string \| null`	No	—	—
`result.data.contacts[].phones[].outbound_sms_blocked`	`boolean`	No	—	—
`result.data.contacts[].phones[].phone`	`string`	Yes	—	—
`result.data.contacts[].phones[].phone_formatted`	`string`	No	—	—
`result.data.contacts[].phones[].type`	`string`	Yes	—	—
`result.data.contacts[].phones[].tz_ids`	`array`	No	—	—
`result.data.contacts[].recent_calls`	`array`	No	—	—
`result.data.contacts[].recent_calls[].dialer_id`	`string \| null`	Yes	—	—
`result.data.contacts[].recent_calls[].duration`	`integer`	Yes	—	—
`result.data.contacts[].recent_calls[].finish_timestamp`	`string`	Yes	—	Format: `date-time`.
`result.data.contacts[].recent_calls[].id`	`string`	Yes	—	—
`result.data.contacts[].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.contacts[].subscriptions`	`array`	No	—	—
`result.data.contacts[].subscriptions[].contact_email`	`string \| null`	Yes	—	—
`result.data.contacts[].subscriptions[].date_created`	`string`	Yes	—	Format: `date-time`.
`result.data.contacts[].subscriptions[].initial_email_id`	`string \| null`	Yes	—	—
`result.data.contacts[].subscriptions[].sequence_id`	`string`	Yes	—	—
`result.data.contacts[].subscriptions[].sequence_name`	`string`	Yes	—	—
`result.data.contacts[].subscriptions[].sequence_status`	`"active" \| "paused" \| "draft"`	Yes	—	Allowed: `active`, `paused`, `draft`.
`result.data.contacts[].subscriptions[].start_date`	`string \| null`	Yes	—	Format: `date-time`.
`result.data.contacts[].subscriptions[].subscription_id`	`string`	Yes	—	—

The table shows the first 50 fields. Expand the raw schema below for every field.

This output schema is too large for an inline display. Read the complete live contract with deepline describe close_create_lead --json.

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