Book a demo

Create Contact

agile_crm.create_contact
ActionCRM & salesconnection required

Calls the Agile CRM API with the connection's credentials.

Create a person contact from the common fields, plus any extra property rows the account defines.

Ask about Agile CRMAll Agile CRM nodesProvider API docs ↗

Connection

Required
Yes — the node will not save without one
Auth type
Username & password
Providers
Agile CRM
Secret shape
{"email": "…", "api_key": "…"}
Config it needs
domain, base_url
Resolved by
config.connection_id, else node.connection_id

Configuration

14 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
first_name
The contact's first name, the one property Agile CRM marks mandatory.
stringYes——Ada
last_name
The contact's last name.
stringNo——Lovelace
email
The contact's email address.
stringNo—email formatada@example.com
email_subtype
Which kind of address this is; Agile CRM stores one per subtype.
stringNoworkone of "work", "personal"—
phone
The contact's phone number.
stringNo——8888888888
phone_subtype
Which kind of number this is; Agile CRM stores one per subtype.
stringNoworkone of "work", "home", "mobile", "main", "home fax", "work fax", "other"—
company
The name of the company the contact works for, stored on the contact itself.
stringNo———
title
The contact's job title.
stringNo———
website
A website for the contact, stored with the URL subtype.
stringNo—url formathttps://example.com
contact_company_id
The numeric id of the company record this contact works for.
stringNo——5649189358796800
properties
Extra property rows to send as-is, each {type, name, value} and a subtype where the field has one.
arrayNo—array of object[{"name":"Company Type","type":"CUSTOM","value":"MNC Inc"}]
tags
Tag names to attach; a tag name must start with a letter and hold no special characters beyond underscore and space.
arrayNo—array of string["Lead"]
lead_score
The record's lead score, which Agile CRM keeps as a positive whole number.
numberNo—≥ 0—
star_value
The record's star rating, from 0 to 5.
numberNo—0–5—

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "contact_company_id": "5649189358796800",
  "email": "ada@example.com",
  "email_subtype": "work",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "phone": "8888888888",
  "phone_subtype": "work",
  "properties": [
    {
      "name": "Company Type",
      "type": "CUSTOM",
      "value": "MNC Inc"
    }
  ],
  "tags": [
    "Lead"
  ],
  "website": "https://example.com"
}

Output

One shape.

result

FieldTypeExample
id
The record's numeric Agile CRM id.
string—
type
PERSON for a contact, COMPANY for a company.
string—
properties
Every property row on the record.
array—
tags
The tag names on the record.
array—
lead_score
The record's lead score.
number—
star_value
The record's star rating, 0 to 5.
number—
contact_company_id
The company record this contact works for.
string—
created_time
Unix timestamp of when the record was created.
string—
updated_time
Unix timestamp of the last change to the record.
number—
owner
The Agile CRM user who owns the record.
object—
{
  "contact_company_id": "",
  "created_time": "",
  "id": "",
  "lead_score": 0,
  "owner": {},
  "properties": [],
  "star_value": 0,
  "tags": [],
  "type": "",
  "updated_time": 0
}

Related Agile CRM nodes

See Create Contact run in a workflow.

In a technical demo we add the Agile CRM connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demoTalk to sales