Update Person
action_network.update_person
ActionCRM & salesconnection required
Calls the Action Network API with the connection's credentials.
Change one or more fields on an existing Action Network person.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Action Network
- Secret shape
- the API key, or {"api_key": "…"}
- Config it needs
- base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
7 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 |
|---|---|---|---|---|---|
person_id The person's Action Network id, with or without the action_network: prefix. | string | Yes | — | — | c945d6fe-929e-11e3-a2e9-12313d316c29 |
given_name The person's first name. | string | No | — | — | Ada |
family_name The person's last name. | string | No | — | — | Lovelace |
email_address The person's email address; Action Network deduplicates people on it. | string | No | — | email format | ada@example.com |
phone_number The person's phone number, digits only, as Action Network stores it. | string | No | — | — | 2021234444 |
postal_code The person's postal code, which Action Network uses for geographic targeting. | string | No | — | — | 20009 |
custom_fields Custom field values for the person, keyed by the custom field's name. | object | No | — | — | {"employer":"Acme"} |
- At least one of given_name, family_name, email_address, phone_number, postal_code, custom_fields must be set.
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"custom_fields": {
"employer": "Acme"
},
"email_address": "ada@example.com",
"family_name": "Lovelace",
"given_name": "Ada",
"person_id": "c945d6fe-929e-11e3-a2e9-12313d316c29",
"phone_number": "2021234444",
"postal_code": "20009"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
identifiers Namespaced ids, the first being action_network:<uuid>. | array | — |
given_name The person's first name, empty when unknown. | string | — |
family_name The person's last name, empty when unknown. | string | — |
email_addresses Each address with its status and primary flag. | array | — |
phone_numbers Each phone number with its status and primary flag. | array | — |
postal_addresses Each postal address, including its postal code. | array | — |
custom_fields The custom field values held on the person. | object | — |
created_date ISO-8601 timestamp of when the person was created. | string | — |
modified_date ISO-8601 timestamp of the last change to the person. | string | — |
{
"created_date": "",
"custom_fields": {},
"email_addresses": [],
"family_name": "",
"given_name": "",
"identifiers": [],
"modified_date": "",
"phone_numbers": [],
"postal_addresses": []
}Related Action Network nodes
See Update Person run in a workflow.
In a technical demo we add the Action Network connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.