View as Markdown
Less Annoying CRM icon

Less Annoying CRM ACTION

Create Contact

Creates a new contact (person) or company in Less Annoying CRM. Run Search Contacts first to avoid creating a duplicate; company names must be unique. Set isCompany to true to create a company, in which case contactName is the company name. For a person, contactName is their full name (e.g. Jane Smith) and employer optionally links/creates their company. If assignedTo is omitted the record is assigned to the API key's owner; use List Users to assign someone else. Returns the new ContactId, which is needed for Create Note, Create Task, and Create Pipeline Item. Use customFields for account-specific fields. Common mistake: passing jobTitle or birthday for a company, which the API does not support. Example: contactName: "Jane Smith", employer: "Acme Inc", emails: ["jane@acme.com"], jobTitle: "VP of Sales" returns {"ContactId": "1234567890123456789012345678901"}. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Less Annoying CRM account once, then configure and run Create Contact from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "less_annoying_crm-create-contact",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    less_annoying_crm: { authProvisionId: "apn_xxxxxxx" },
    isCompany: true,
    contactName: "Contact Name",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Contact inputs
Property Type Description
isCompany Is Company boolean
True to create a company, false (default) to create a person, e.g. true.
Optional
contactName Contact Name string
Full name of the person, or the company name when isCompany is true, e.g. Jane Smith or Acme Inc.
Required
employer Employer (Company Name) string
For a person: the company they work for, e.g. Acme Inc. Creates the company if it does not exist. Ignored for companies.
Optional
assignedTo Assigned To (User ID) string
The ID of the CRM user to assign to (a numeric string, e.g. 1240220). Use List Users to find user IDs.
Optional
emails Email Addresses string[]
Email addresses, e.g. ["jane@acme.com"]. All are saved with the label in Contact Info Label.
Optional
phones Phone Numbers string[]
Phone numbers, e.g. ["555-123-4567"]. All are saved with the label in Contact Info Label.
Optional
websites Websites string[]
Website URLs, e.g. ["https://acme.com"].
Optional
infoType Contact Info Label string
Label applied to the emails, phones, and address (e.g. Work, Home, Other). Must match a type configured in the CRM. Leave blank to use the account's first type.
Optional
street Street string
Street address, e.g. 123 Main St. Street, city, state, zip, and country are saved together as one address.
Optional
city City string
City for the address, e.g. Austin.
Optional
state State string
State or region for the address, e.g. TX.
Optional
zip Zip string
Zip or postal code for the address, e.g. 78701.
Optional
country Country string
Country for the address, e.g. United States.
Optional
jobTitle Job Title string
Job title, e.g. VP of Sales. Applies to people only, not companies.
Optional
backgroundInfo Background Info string
Free-text background information shown on the record, e.g. Met at the 2026 trade show; prefers email over phone.
Optional
birthday Birthday string
Birthday as YYYY-MM-DD, e.g. 1985-03-21, or 0000-MM-DD (e.g. 0000-03-21) if the year is unknown. People only.
Optional
customFields Custom Fields string
JSON object of account-specific custom field values keyed by field name, e.g. {"Lead Source": "Referral"}. Merged into the request as-is.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
less_annoying_crm-create-contact
Version
0.0.1
App
Less Annoying CRM
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes