# Create Note — Less Annoying CRM

> Adds a note to a contact or company's history in Less Annoying CRM. Get the contactId from Search Contacts first; the record must already exist. For a lead, use the ContactId on the pipeline item. note is plain text (new lines are kept…

- Key: `less_annoying_crm-create-note`
- Type: Action (Write)
- Version: 0.0.1
- App: Less Annoying CRM (`less_annoying_crm`) — https://pipedream.com/apps/less-annoying-crm.md
- This page (HTML): https://pipedream.com/apps/less-annoying-crm/actions/create-note
- Hints: open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/less_annoying_crm/actions/create-note/create-note.mjs

## Description

Adds a note to a contact or company's history in Less Annoying CRM. Get the `contactId` from **Search Contacts** first; the record must already exist. For a lead, use the `ContactId` on the pipeline item. `note` is 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 its `note` parameter instead. Returns the new `NoteId`. Example: `contactId: "1234567890123456789012345678901", note: "Called Jane; she wants a quote by Friday."` returns `{"NoteId": "1234567890123456789012345678908"}`. [See the documentation](https://account.lessannoyingcrm.com/api_docs/v2/Core_Functions/Notes#Goto-CreateNote)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `contactId` | `string` | Yes | The ID of a contact or company (a long numeric string, e.g. 4135054762542398391286410820683). Use Search Contacts to find it by name, email, or phone. |
| `note` | `string` | Yes | Plain-text note content, e.g. Called Jane about the quote. |
| `dateDisplayedInHistory` | `string` | No | When the note should appear in the contact's history, as ISO 8601 (e.g. 2025-07-25T16:00:00-05:00). Defaults to now. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_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()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "less_annoying_crm-create-note",
  arguments: {
    contactId: "Contact ID",
    note: "Note",
  },
})
```

**TypeScript**

```ts
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-note",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    less_annoying_crm: { authProvisionId: "apn_xxxxxxx" },
    contactId: "Contact ID",
    note: "Note",
  },
})

console.log(result)
```

**cURL**

```bash
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-note",
    "configured_props": {
      "less_annoying_crm": { "authProvisionId": "apn_xxxxxxx" },
      "contactId": "Contact ID",
      "note": "Note"
    }
  }'
```

---

- App: https://pipedream.com/apps/less-annoying-crm.md · All apps: https://pipedream.com/apps
