---
title: "Create a note for a specific contact"
description: "POST /contacts/{contact_id}/notes — Logs a note against this contact. text carries the note body; link a deal with linked_deal_id. Logging a note updates the contact's last activity date."
canonical_url: https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-notes/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-notes/
---

`POST /contacts/{contact_id}/notes`

Logs a note against this contact. text carries the note body; link a deal with linked_deal_id. Logging a note updates the contact's last activity date.

Resource: [Contacts](https://developer.onepagecrm.com/api/reference/contacts/) · [API Reference](https://developer.onepagecrm.com/api/reference/)

## Request

```bash
curl -X POST "https://app.onepagecrm.com/api/v3/contacts/{contact_id}/notes" \
  -u $user_id:$api_key \
  -H "Content-Type: application/json" \
  -d '{
    "text": "I met Jane Doe at the ABC conference. She's interested in hearing about XYZ.",
    "date": "2018-05-16",
    "linked_deal_id": "",
    "user_ids_to_notify": [
      "5aba31e99007ba0f570c12f7"
    ]
  }'
```

Authentication is HTTP Basic — `user_id` as username, `api_key` as password.
See https://developer.onepagecrm.com/api/authentication/.

## Path parameters

| Name | Type | Description |
| --- | --- | --- |
| `contact_id` | string | Contact ID |

## Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `text` | string |  | Extra details related to the note(supports `[b]bold[/b]` and `[i]italic[/i]` formatting) |
| `date` | string (date) |  | Creation date of the note. Defaults to today's date. |
| `linked_deal_id` | string (bson-id) |  |  |
| `user_ids_to_notify` | array<string (bson-id)> |  | A list of user IDs to notify |

## Responses

### 201

Created

```json
{
  "status": 0,
  "message": "OK",
  "timestamp": 1528373119,
  "data": {
    "note": {
      "id": "5afc1b69d556730b580596cb",
      "contact_id": "5ae06ef9d55673108fe8877f",
      "text": "I met Jane Doe at the ABC conference. She's interested in hearing about XYZ.",
      "date": "2018-05-16",
      "linked_deal_id": "",
      "linked_deal_name": "",
      "author": "Jane D.",
      "attachments": [
        {
          "id": "5afc1ea9d556730b780096db",
          "filename": "mario.jpg",
          "custom_filename": "another_mario.jpg",
          "pinned": true,
          "pinned_at": "2022-01-24T10:42:39Z",
          "size": 3841,
          "storage_provider": "amazon",
          "url": "https://{foo.bar}/mario.jpg",
          "url_expires_at": "2018-05-16T13:06:53Z",
          "thumbnail": {
            "url": "https://{foo.bar}/mario-thumbnail.jpg"
          }
        }
      ],
      "created_at": "2018-05-16T11:52:09Z",
      "modified_at": "2018-05-16T11:52:09Z"
    }
  }
}
```

Standard error responses: 400, 401, 403, 404, 409, 500 — shared across the API. See https://developer.onepagecrm.com/api/errors/.

## Related guides

- [Authentication](https://developer.onepagecrm.com/api/authentication/)
- [Errors](https://developer.onepagecrm.com/api/errors/)
- [Rate limits](https://developer.onepagecrm.com/api/rate-limits/)