CONNECT APP
Build with Less Annoying CRM
CRM
- API key
MCP
Give your agent Less Annoying CRM tools
Every Less Annoying CRM action is exposed as an MCP tool on Pipedream's remote server. Point a client at it with your end user's ID and Connect resolves that user's Less Annoying CRM account for each tool call — you store no tokens.
// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "less_annoying_crm",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// e.g. run Create Contact:
const result = await mcp.callTool({
name: "less_annoying_crm-create-contact",
arguments: {
isCompany: true,
contactName: "Contact Name",
},
})# access_token: mint a short-lived token with the Connect SDK — see the MCP guide
headers = {
"Authorization": f"Bearer {access_token}",
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", # any stable ID for this user in your system
"x-pd-app-slug": "less_annoying_crm",
}
async with streamablehttp_client("https://remote.mcp.pipedream.net/v3", headers=headers) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await session.list_tools()
# e.g. run Create Contact:
result = await session.call_tool("less_annoying_crm-create-contact", {
"isCompany": True,
"contactName": "Contact Name",
})API PROXY
Call the Less Annoying CRM API directly
For an endpoint with no pre-built tool, the Connect proxy forwards your request to the Less Annoying CRM API with the connected user's credentials attached. You store no tokens and write no refresh logic.
const resp = await pd.proxy.get({
externalUserId: "{external_user_id}", // any stable ID for this user in your system
accountId: "apn_xxxxxxx",
url: "https://api.lessannoyingcrm.com/v2/",
})
// Any allowed Less Annoying CRM endpoint works here. Pipedream attaches the
// connected account's credentials to the outgoing request.# The path segment is the target URL, URL-safe base64 encoded:
# https://api.lessannoyingcrm.com/v2/
curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkubGVzc2Fubm95aW5nY3JtLmNvbS92Mi8?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
-H "Authorization: Bearer {access_token}" \
-H "x-pd-environment: production"SDK
Run Less Annoying CRM actions from your backend
Connect a user's Less Annoying CRM account once, then run Create Contact on their behalf from your own code — TypeScript, Python, or plain HTTP.
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",
},
})from pipedream import Pipedream
pd = Pipedream(
client_id="{oauth_client_id}",
client_secret="{oauth_client_secret}",
project_id="{project_id}",
project_environment="production",
)
result = pd.actions.run(
id="less_annoying_crm-create-contact",
external_user_id="{external_user_id}", # any stable ID for this user in your system
configured_props={
"less_annoying_crm": {"authProvisionId": "apn_xxxxxxx"},
"isCompany": True,
"contactName": "Contact Name",
},
)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "less_annoying_crm-create-contact",
"configured_props": {
"less_annoying_crm": { "authProvisionId": "apn_xxxxxxx" },
"isCompany": true,
"contactName": "Contact Name"
}
}'TOOLS
Less Annoying CRM actions
On-demand operations your product or agent can configure and run on behalf of a connected user.
-
Create Contact
actionCreates a new contact (person) or company in Less Annoying CRM. Run Search Contacts first to avoid creating a duplicate; company names must be unique. SetisCompanyto true to create a company, in which casecontactNameis the company name. For a person,contactNameis their full name (e.g.Jane Smith) andemployeroptionally links/creates their company. IfassignedTois omitted the record is assigned to the API key's owner; use List Users to assign someone else. Returns the newContactId, which is needed for Create Note, Create Task, and Create Pipeline Item. UsecustomFieldsfor account-specific fields. Common mistake: passingjobTitleorbirthdayfor 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 documentationWritev0.0.1 -
Create Note
actionAdds a note to a contact or company's history in Less Annoying CRM. Get thecontactIdfrom Search Contacts first; the record must already exist. For a lead, use theContactIdon the pipeline item.noteis plain text (new lines are kept; HTML and Markdown are escaped, not rendered). To log a note while moving a lead to a new status, use Update Pipeline Item with itsnoteparameter instead. Returns the newNoteId. Example:contactId: "1234567890123456789012345678901", note: "Called Jane; she wants a quote by Friday."returns{"NoteId": "1234567890123456789012345678908"}. See the documentationWritev0.0.1 -
Create Pipeline Item
actionAdds a contact or company to a pipeline at a given status in Less Annoying CRM. Use this to create a lead (pipeline item in the "Leads" pipeline) or any other pipeline item. Use List Pipelines first to getpipelineIdandstatusId, and Search Contacts to getcontactId(create the contact with Create Contact if it does not exist). The optionalnoteappears in the item's history. SetrunStatusAutomationonly if the user wants the status's configured automation to fire (e.g. send an email or create tasks). Returns the newPipelineItemId. Example:contactId: "1234567890123456789012345678901", pipelineId: "1234567890123456789012345678904", statusId: "1234567890123456789012345678905", note: "Inbound website inquiry"returns{"PipelineItemId": "1234567890123456789012345678903"}. See the documentationWritev0.0.1 -
Create Task
actionCreates a task (e.g. a follow-up) in Less Annoying CRM, optionally attached to a contact, company, or lead's contact. Use for "remind me to follow up with X on Friday" requests: find thecontactIdwith Search Contacts, convert the relative date to an absolutedueDateofYYYY-MM-DD. The task is assigned to the API key's owner unlessassignedTo(a user ID from List Users) is given.dueDateis a date only, with no time or timezone. Returns the newTaskId. Example:taskName: "Follow up on proposal", dueDate: "2025-08-01", contactId: "1234567890123456789012345678901"returns{"TaskId": "1234567890123456789012345678906"}. See the documentationWritev0.0.1 -
Get Contact
actionRetrieves one contact or company from Less Annoying CRM by ID, including emails, phones, addresses, websites, job title, background info, owner, and custom fields. Use Search Contacts first if you only have a name or email. To see notes, tasks, events, and leads for the record, use Get Contact Activities. Example:contactId: "1234567890123456789012345678901"returns{"ContactId": "1234567890123456789012345678901", "IsCompany": false, "Name": {"FirstName": "Jane", "LastName": "Smith"}, "Email": [{"Text": "jane@acme.com", "Type": "Work"}], "Job Title": "VP of Sales", "AssignedTo": "101", ...}. See the documentationRead-onlyv0.0.1 -
Get Contact Activities
actionRetrieves the activity attached to a contact, company, or lead's contact record: notes, tasks (including completed), calendar events, and pipeline items (leads) with their current status. Use this for "what's happened with X", "show the history for X", or "what's open for X" requests. Get thecontactIdfrom Search Contacts; for a lead, use theContactIdon the pipeline item from Search Pipeline Items. By default all four types are returned; passincludeto fetch only some (e.g.["notes", "tasks"]). Returns an object keyed by type. Each of notes/tasks/events hashasMoreResultsandresults; ifhasMoreResultsis true, call again withpageincremented (or raisemaxResults).pipelineItemsis grouped by pipeline. Records are trimmed to their key fields. Example:contactId: "1234567890123456789012345678901", include: ["tasks"]returns{"tasks": {"hasMoreResults": false, "results": [{"TaskId": "…", "Name": "Follow up on proposal", "DueDate": "2025-08-01", "IsCompleted": false}]}}. See the documentationRead-onlyv0.0.1 -
List Pipelines
actionLists all pipelines (e.g. Leads) in the Less Annoying CRM account along with each pipeline's statuses and their IDs. Use this before Search Pipeline Items, Create Pipeline Item, or Update Pipeline Item to find thepipelineIdandstatusIdvalues they require. Leads are pipeline items in the pipeline named "Leads". Statuses withIsActive: falseare closed/inactive. Example result:[{"PipelineId": "1234567890123456789012345678904", "Name": "Leads", "Statuses": [{"StatusId": "1234567890123456789012345678905", "Name": "New", "IsActive": true}, {"StatusId": "1234567890123456789012345678907", "Name": "Closed - Won", "IsActive": false}]}]. See the documentationRead-onlyv0.0.1 -
List Users
actionReturns the current user (the owner of the API key) and all users in the Less Annoying CRM account, with their user IDs and timezones. Use this first when the user says "my" or "me" (e.g. "my contacts", "assign to me") to get their user ID, or to resolve a teammate's name to a user ID for theassignedToparameter of Create Contact, Update Contact, and Create Task. Takes no inputs. Example result:{"currentUser": {"UserId": "1240220", "FirstName": "Alex", "LastName": "Doe", "Email": "alex@acme.com", "Timezone": "America/Chicago"}, "users": [{"UserId": "1240220", "FirstName": "Alex", "LastName": "Doe"}, {"UserId": "1240221", "FirstName": "Sam", "LastName": "Lee"}]}. See the documentationRead-onlyv0.0.1 -
Search Contacts
actionSearches contacts and companies in Less Annoying CRM by free text (name, email, phone, etc.), with optional filters for record type, owner, and sorting. With no search terms it lists records. Use this to find acontactIdbefore calling Get Contact, Get Contact Activities, Update Contact, Create Note, Create Task, or Create Pipeline Item. For "my contacts", get the user ID from List Users and pass it inownerIds.advancedFiltersis an optional JSON array of{"Name": field, "Operation": op, "Value": value}objects; see the filter docs for valid operations. ReturnsresultsplushasMoreResults; if true, call again withpageincremented. Each result is trimmed to ContactId, IsCompany, Name, Company Name, Job Title, Email, Phone, AssignedTo, and LastUpdate; passfields(e.g.["Address", "Background Info"]) to get other fields too, or use Get Contact for the full record. Example:searchTerms: "jane@acme.com"returns{"hasMoreResults": false, "results": [{"ContactId": "1234567890123456789012345678901", "IsCompany": false, "Name": {"FirstName": "Jane", "LastName": "Smith"}, "Email": [{"Text": "jane@acme.com", "Type": "Work"}], ...}]}. See the documentationRead-onlyv0.0.1 -
Search Pipeline Items
actionLists pipeline items (leads, deals, etc.) in one Less Annoying CRM pipeline, optionally filtered by status or owner. Each item includes its status, the attached contact, last note, and timestamps. Use List Pipelines first to getpipelineIdandstatusIds(e.g. the "Leads" pipeline and its "Open" status). For "my leads", get the user ID from List Users and pass it inuserIds. To find leads for one specific contact, use Get Contact Activities withinclude: ["pipelineItems"]instead.advancedFiltersis an optional JSON array of{"Name", "Operation", "Value"}objects; see the filter docs. ReturnsresultsplushasMoreResults; if true, call again withpageincremented. Example:pipelineId: "1234567890123456789012345678904", statusIds: ["1234567890123456789012345678905"]returns{"hasMoreResults": false, "results": [{"PipelineItemId": "1234567890123456789012345678903", "StatusId": "1234567890123456789012345678905", "ContactId": "1234567890123456789012345678901", "LastNote": "Inbound website inquiry", "ContactMetaData": {"Name": "Jane Smith"}, ...}]}. See the documentationRead-onlyv0.0.1 -
Update Contact
actionUpdates an existing contact or company in Less Annoying CRM. Only the fields you provide are changed; omitted fields are left as-is. Get thecontactIdfrom Search Contacts first.namerenames the record (for a company it sets the company name; the action detects which).employerchanges the company a person works for. Warning:emails,phones,websites, and the address fields REPLACE the existing values for that field rather than appending, so include existing entries you want to keep (read them with Get Contact). UseassignedTo(user ID from List Users) to reassign ownership, andcustomFieldsfor account-specific fields. Returns a confirmation; call Get Contact to see the updated record. Example:contactId: "1234567890123456789012345678901", jobTitle: "CEO", phones: ["555-123-4567"]returns{"success": true, "ContactId": "1234567890123456789012345678901"}. See the documentationWritev0.0.1 -
Update Pipeline Item
actionMoves a pipeline item (lead, deal, etc.) to a new status in Less Annoying CRM and/or adds a history note. Use for "mark the Acme lead as won" or "move X to Contacted" requests. GetpipelineItemIdfrom Search Pipeline Items (or Get Contact Activities withinclude: ["pipelineItems"]), and the targetstatusIdfrom List Pipelines (statuses are specific to each pipeline). SetrunStatusAutomationonly if the user wants the new status's automation to fire. Returns a confirmation. Example:pipelineItemId: "1234567890123456789012345678903", statusId: "1234567890123456789012345678907", note: "Signed contract"returns{"success": true, "PipelineItemId": "1234567890123456789012345678903"}. See the documentationWritev0.0.1
EVENTS
Less Annoying CRM triggers
Event sources your backend can deploy for users and receive through a webhook.
-
New Contact or Company (Instant)
triggerEmit new event when a contact or company is created in Less Annoying CRM. See the documentationInstantv0.0.1 -
New Contact or Company Update (Instant)
triggerEmit new event when a contact or company is updated in Less Annoying CRM. See the documentationInstantv0.0.1 -
New Lead or Pipeline Item (Instant)
triggerEmit new event when a lead or other pipeline item is created in Less Annoying CRM. See the documentationInstantv0.0.1 -
New Lead or Pipeline Item Status Change (Instant)
triggerEmit new event when the status of a lead or other pipeline item changes in Less Annoying CRM. See the documentationInstantv0.0.1
REFERENCE
App details
Reference metadata for the Less Annoying CRM connector in the Pipedream registry.
- App slug
- less_annoying_crm
- Authentication
- API key
- Categories
- CRM
- Actions
- 12
- Triggers
- 4
- API proxy
- Available