Create Person
copper.create_person
ActionCRM & salesconnection required
Calls the Copper API with the connection's credentials.
Create a Person (contact) in Copper. Copper requires only a name; everything else on the form is optional.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Copper
- Secret shape
- the API key, or {"api_key": "…"}
- Config it needs
- user_email, base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
12 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 person's full name; Copper splits it into first and last name. | string | Yes | — | — | Jane Doe |
email The person's email address. Copper treats email as the unique key for People. | string | No | — | email format | jane@example.com |
email_category Which address this is, in Copper's own category vocabulary. | string | Conditional | work | one of "work", "personal", "other"; only with email | — |
phone A phone number for the person. | string | No | — | — | — |
phone_category Which number this is, in Copper's own category vocabulary. | string | Conditional | work | one of "work", "mobile", "home", "other"; only with phone | — |
company_id The Copper Company this person works for. | string | No | — | — | — |
title The person's job title. | string | No | — | — | — |
details A description stored on the record. | string | No | — | — | — |
assignee_id The Copper user who should own this record. | string | No | — | — | — |
contact_type_id A contact type id from copper.list_contact_types, such as Potential Customer. | string | No | — | — | — |
tags Tags to set on the record, as a JSON array of strings or a comma-separated list. | array | No | — | array of string | — |
fields Any further Copper fields, as a JSON object of Copper field names (custom_fields, address, websites, socials …). These are merged over the fields named above, so this node can set anything the API accepts. | object | No | — | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"email": "jane@example.com",
"email_category": "work",
"name": "Jane Doe",
"phone_category": "work"
}Output
One shape.
result
The provider's response object, as returned.
Extra keys beyond the ones listed can appear.
{}See Create Person run in a workflow.
In a technical demo we add the Copper connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.