Create Company
agile_crm.create_company
ActionCRM & salesconnection required
Calls the Agile CRM API with the connection's credentials.
Create a company record; Agile CRM stores companies on the contacts endpoint with a COMPANY type.
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
8 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
name The company's name. | string | Yes | — | — | Spicejet |
url The company's website address. | string | No | — | url format | https://example.com |
email A contact email address for the company. | string | No | — | email format | care@example.com |
phone A contact phone number for the company. | string | No | — | — | 45500000 |
properties Extra property rows to send as-is, each {type, name, value} and a subtype where the field has one. | array | No | — | 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. | array | No | — | array of string | ["Lead"] |
lead_score The record's lead score, which Agile CRM keeps as a positive whole number. | number | No | — | ≥ 0 | — |
star_value The record's star rating, from 0 to 5. | number | No | — | 0–5 | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"email": "care@example.com",
"name": "Spicejet",
"phone": "45500000",
"properties": [
{
"name": "Company Type",
"type": "CUSTOM",
"value": "MNC Inc"
}
],
"tags": [
"Lead"
],
"url": "https://example.com"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
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
}See Create Company 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.