---
title: "Create a Note activity"
method: POST
path: "/activity/note/"
tags: ["activities.notes"]
---

# Create a Note activity

`POST /activity/note/`

To include an attachment, you must first upload the file to Close using the [Files API](https://developer.close.com/api/resources/files). Then, add an object to the `attachments` array with the following fields: `url`, `filename` and `content_type`. The `url` should be the URL provided in the `download.url` field of the response from the [Files API](https://developer.close.com/api/resources/files). It must begin `https://app.close.com/go/file/`.

A note can be pinned or unpinned by setting the `pinned` field to `true` or `false` when creating or updating a note.

## Request body

- CreateNoteActivity
  - `activity_at` string, date-time, nullable
  - `attachments` object[], nullable
    - `content_type` string, nullable
    - `filename` string, required
    - `url` string, uri, required
  - `contact_id` string, nullable
  - `created_by` string, nullable
  - `date_created` string, date-time, nullable
  - `lead_id` string, required
  - `note` string, nullable
  - `note_html` string, nullable
  - `organization_id` string, nullable
  - `pinned` boolean, nullable
  - `title` string, nullable
  - `user_id` string, nullable

## Response `200`

Successful response

- ActivityBase
  - `_type` string, required
  - `activity_at` string, date-time, nullable, required
  - `attachments` Attachment[], required
    - `content_type` string, nullable, required
    - `filename` string, nullable, required
    - `size` integer, nullable, required
    - `thumbnail_url` string, nullable
    - `url` string, required
  - `comment_summary` CommentSummary
    - `comment_count` integer, required
    - `thread_id` string, required
  - `contact_id` string, nullable, required
  - `created_by` string, nullable, required
  - `created_by_name` string, nullable
  - `date_created` string, date-time, required
  - `date_updated` string, date-time, required
  - `id` string, required
  - `lead_id` string, nullable, required
  - `note` string, required
  - `note_html` string, required
  - `note_mentions` string[], required
  - `organization_id` string, required
  - `pinned` boolean, required
  - `pinned_at` string, date-time, nullable, required
  - `source` 'ui' | 'api' | 'import' | 'clipper' | 'email' | 'suggestion' | 'segment-integration' | 'customerio-integration' | 'calendly-integration' | 'ai' | 'whatsapp' | 'webform', required
  - `title` string, nullable, required
  - `updated_by` string, nullable, required
  - `updated_by_name` string, nullable
  - `user_id` string, nullable, required
  - `user_name` string, nullable
  - `users` string[], required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/close/apis/close-api.md) · [All operations](https://skmtc.net/close/apis/close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/close/close-api/revisions/0dcf3303e9d7/schema)