Update Contacts (Batch)

mautic.batch_update_contacts

ActionCRM & salesconnection required

Calls the Mautic API with the connection's credentials.

Update many contacts in one call and report the outcome of each one separately.

Connection

Required: Yes — the node will not save without one
Auth type: OAuth 2.0
Providers: Mautic
Secret shape: {"client_id": "…", "client_secret": "…", "refresh_token": "…"}
Config it needs: base_url
Resolved by: config.connection_id, else node.connection_id

2 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
contacts The contacts to update; every entry needs an 'id' plus the fields to change.	array	Yes	—	array of object	[{"firstname":"Ada","id":1}]
create_if_missing Send PUT instead of PATCH: creates any contact whose id does not exist, but clears every contact field you do not send.	boolean	No	false	—	—

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

{
  "contacts": [
    {
      "firstname": "Ada",
      "id": 1
    }
  ],
  "create_if_missing": false
}

One shape.

Field	Type	Example
records The records Mautic processed, in the order they were sent.	array	—
status_codes Mautic's per-record HTTP status code, one per record sent.	array	—
errors Mautic's per-record error entries; empty when nothing failed.	array	—
succeeded How many records Mautic answered with a status below 400.	number	—
failed How many records Mautic refused.	number	—
partial True when the same batch both wrote and refused records.	boolean	—

{
  "errors": [],
  "failed": 0,
  "partial": false,
  "records": [],
  "status_codes": [],
  "succeeded": 0
}

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