Create Contact
Module · Stable
Create a contact or return the existing one (idempotent on email → name).
Creates a contact. Idempotent on email: if a contact with the same address already exists the existing record is returned with created: false. Supply company_name to auto-resolve or create the parent company in one step.
When to use
Section titled “When to use”Use at the top of an onboarding or lead-capture flow when you have a name (and optionally a company name) coming in from a form, webhook, or incoming email, and need a guaranteed contact_id to hand to downstream steps like Add Note, Create Deal, or Create Task.
When not to use
Section titled “When not to use”If the contact already exists and you only need to look it up, use Find Contact — it avoids an unnecessary write. If you need to change fields on an existing record, use Update Contact instead.
Inputs
Section titled “Inputs”Configured per use: name, company_name.
Outputs
Section titled “Outputs”Auto-generated from the skill registry (load_skills()). Do not edit by hand.