---
title: "Create activity"
method: POST
path: "/notes"
tags: ["Activities (Notes)"]
---

# Create activity

`POST /notes`

## Request

- Base URL: `https://api.pipelinecrm.com/api/v3`
- URL: `https://api.pipelinecrm.com/api/v3/notes`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `app-key`
  - API key in query parameter `api_key` and API key in query parameter `app_key`

## Request body

- object
  - `note` ActivityWritable
    - `created_at` string: Timestamp when the record was created (time zone in user's time zone).
    - `updated_at` string: Timestamp when the record was last touched (time zone in user's time zone).
    - `user_id` integer: The owner of the note
    - `title` string, nullable: The note title, if any
    - `content` string: The note content
    - `deal_id` integer, nullable: The deal id of the note
    - `company_id` integer, nullable: The company id of the note
    - `person_id` integer, nullable: The person id of the note
    - `milestone_id` integer
    - `comments` object: An embedded list of [comments](#tag/comments) on the given note
      - `entries` CommentAll[]
        - `id` integer: Unique identifier
        - `created_at` string: Timestamp when the record was created (time zone in user's time zone).
        - `updated_at` string: Timestamp when the record was last touched (time zone in user's time zone).
        - `user` object: A convenience object to get the full name of the comment owner
          - `id` integer
          - `first_name` string
          - `last_name` string
          - `avatar_thumb_url` string, nullable
        - `user_id` integer: The owner of the comment
        - `comment` string: The content of the comment
        - `edited_by_person_id` integer: The user id of the last person to edit the note; must be manually set when updating a comment.
    - `note_category_id` integer, nullable: The category of the note
    - `notify_user_ids` integer[]: These are the ids of the users who will receive emails when new comments are added to the given note/activity.

## Response `200`

Successful Response

- ActivityAll
  - `id` integer: Unique identifier
  - `account_id` integer
  - `possible_notify_user_ids` integer[]: The list of user_ids that can be added to notify_user_ids.
  - `is_sent_message` boolean, nullable: Describes if an activity with Email category is a sent or received message. It can also have a value of `null` for other activity categories.
  - `primary_association_id` integer: The primary association model id of the note
  - `primary_association_type` 'Deal' | 'Person' | 'Company': The primary association type name
  - `user` object: A convenience object to get the full name of the note owner
    - `id` integer
    - `first_name` string
    - `last_name` string
    - `avatar_thumb_url` string, nullable
  - `note_category` object, nullable: A convenience object to get the name of the note category
    - `id` integer
    - `name` string
  - `created_at` string: Timestamp when the record was created (time zone in user's time zone).
  - `updated_at` string: Timestamp when the record was last touched (time zone in user's time zone).
  - `user_id` integer: The owner of the note
  - `title` string, nullable: The note title, if any
  - `content` string: The note content
  - `deal_id` integer, nullable: The deal id of the note
  - `company_id` integer, nullable: The company id of the note
  - `person_id` integer, nullable: The person id of the note
  - `milestone_id` integer
  - `comments` object: An embedded list of [comments](#tag/comments) on the given note
    - `entries` CommentAll[]
      - `id` integer: Unique identifier
      - `created_at` string: Timestamp when the record was created (time zone in user's time zone).
      - `updated_at` string: Timestamp when the record was last touched (time zone in user's time zone).
      - `user` object: A convenience object to get the full name of the comment owner
        - `id` integer
        - `first_name` string
        - `last_name` string
        - `avatar_thumb_url` string, nullable
      - `user_id` integer: The owner of the comment
      - `comment` string: The content of the comment
      - `edited_by_person_id` integer: The user id of the last person to edit the note; must be manually set when updating a comment.
  - `note_category_id` integer, nullable: The category of the note
  - `notify_user_ids` integer[]: These are the ids of the users who will receive emails when new comments are added to the given note/activity.

---

[API](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api.md) · [All operations](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/revisions/53ebfcc83597?raw)