Update Contact
agile_crm.update_contact
ActionCRM & salesconnection required
Calls the Agile CRM API with the connection's credentials.
Add or replace property values on an existing contact; Agile CRM cannot delete a property this way, and leaves every other field alone.
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
11 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 |
|---|---|---|---|---|---|
contact_id The numeric id of the Agile CRM contact or company to act on. | string | Yes | — | — | 5725836472745984 |
first_name The contact's first name, the one property Agile CRM marks mandatory. | string | No | — | — | Ada |
last_name The contact's last name. | string | No | — | — | Lovelace |
email The contact's email address. | string | No | — | email format | ada@example.com |
email_subtype Which kind of address this is; Agile CRM stores one per subtype. | string | No | work | one of "work", "personal" | — |
phone The contact's phone number. | string | No | — | — | 8888888888 |
phone_subtype Which kind of number this is; Agile CRM stores one per subtype. | string | No | work | one 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. | string | No | — | — | — |
title The contact's job title. | string | No | — | — | — |
website A website for the contact, stored with the URL subtype. | string | No | — | url format | https://example.com |
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"}] |
- At least one of first_name, last_name, email, phone, company, title, website, properties must be set.
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"contact_id": "5725836472745984",
"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"
}
],
"website": "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 Update 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.