Book a demo

Create Person

affinity.create_person
ActionCRM & salesconnection required

Calls the Affinity API with the connection's credentials.

Create a person in Affinity with their name and email addresses.

Ask about AffinityAll Affinity nodesProvider API docs ↗

Connection

Required
Yes — the node will not save without one
Auth type
API key
Providers
Affinity
Secret shape
the API key, or {"api_key": "…"}
Config it needs
base_url
Resolved by
config.connection_id, else node.connection_id

Configuration

4 fields, 3 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
first_name
The person's first name, which Affinity requires on create.
stringYes——Ada
last_name
The person's last name, which Affinity requires on create.
stringYes——Lovelace
emails
The person's email addresses; Affinity requires at least one.
arrayYes—≥ 1 characters; array of string["ada@example.com"]
organization_ids
Numeric ids of the organizations this person should be linked to.
arrayNo—array of string["12345"]

Example configuration

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

{
  "emails": [
    "ada@example.com"
  ],
  "first_name": "Ada",
  "last_name": "Lovelace",
  "organization_ids": [
    "12345"
  ]
}

Output

One shape.

result

FieldTypeExample
id
The person's numeric id.
number—
type
Whether the person is internal or external to the workspace.
number—
first_name
The person's first name.
string—
last_name
The person's last name.
string—
primary_email
The person's primary email address.
string—
emails
Every email address held on the person.
array—
organization_ids
Ids of the organizations the person is linked to.
array—
list_entries
The list entries pointing at this person.
array—
{
  "emails": [],
  "first_name": "",
  "id": 0,
  "last_name": "",
  "list_entries": [],
  "organization_ids": [],
  "primary_email": "",
  "type": 0
}

Related Affinity nodes

See Create Person run in a workflow.

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

Book a technical demoTalk to sales