Create Contact

keap.create_contact

ActionCRM & salesconnection required

Calls the Keap API with the connection's credentials.

Create a contact in Keap from an object of Keap's own field names, such as given_name, family_name and email_addresses.

Ask about Keap All Keap nodes Provider API docs ↗

Connection

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

Configuration

1 field, 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 The contact as Keap's own fields, for example {"given_name": "Ada", "email_addresses": [{"email": "ada@example.com", "field": "EMAIL1"}]}.	object	Yes	—	—	{"email_addresses":[{"email":"ada@example.com","field":"EMAIL1"}],"family_name":"Lovelace","given_name":"Ada"}

Example configuration

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

{
  "contact": {
    "email_addresses": [
      {
        "email": "ada@example.com",
        "field": "EMAIL1"
      }
    ],
    "family_name": "Lovelace",
    "given_name": "Ada"
  }
}

Output

One shape.

result

The provider's response object, as returned.

Extra keys beyond the ones listed can appear.

{}

Notes

Keap requires at least one email_addresses or phone_numbers entry on a new contact, and a country_code whenever an address names a region.
Each email_addresses entry needs a field of EMAIL1, EMAIL2 or EMAIL3.

Related Keap nodes

See Create Contact run in a workflow.

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

Book a technical demo Talk to sales