Create a deal note

POST  https://:account.api-us1.com/api/3/deals/id/notes

• JSON

{
  "note": {
    "note": "Note for the deal"
  }
}

 

201 Created

{
  "deals": [
    {
      "activitycount": "2",
      "cdate": "2017-05-25T12:01:01-05:00",
      "contact": "1",
      "currency": "usd",
      "edate": null,
      "group": "1",
      "hash": "e42436fc",
      "id": "1",
      "links": {
        "dealActivities": "/api/3/deals/1/dealActivities",
        "contact": "/api/3/deals/1/contact",
        "contactDeals": "/api/3/deals/1/contactDeals",
        "group": "/api/3/deals/1/group",
        "nextTask": "/api/3/deals/1/nextTask",
        "notes": "/api/3/deals/1/notes",
        "organization": "/api/3/deals/1/organization",
        "owner": "/api/3/deals/1/owner",
        "scoreValues": "/api/3/deals/1/scoreValues",
        "stage": "/api/3/deals/1/stage",
        "tasks": "/api/3/deals/1/tasks"
      },
      "mdate": "2017-05-25T12:17:23-05:00",
      "nextdate": null,
      "nextdealid": "1",
      "nexttaskid": null,
      "organization": null,
      "owner": "1",
      "percent": "0",
      "stage": "1",
      "status": "0",
      "title": "New Deal",
      "value": "10000"
    }
  ],
  "note": {
    "cdate": "2017-05-31T09:54:30-05:00",
    "id": "2",
    "links": {
      "activities": "/api/3/notes/2/activities",
      "mentions": "/api/3/notes/2/mentions",
      "notes": "/api/3/notes/2/notes",
      "owner": "/api/3/notes/2/owner",
      "user": "/api/3/notes/2/user"
    },
    "mdate": "2017-05-31T09:54:30-05:00",
    "note": "Note for the deal",
    "owner": {
      "id": "1",
      "type": "deal"
    },
    "relid": "1",
    "reltype": "Deal",
    "user": "1",
    "userid": "1"
  }
}

PATH PARAMS

id                                                 REQUIRED

string                                          Deal's id to assign new note to

 

BODY PARAMS

note

object

 

note.note                                    REQUIRED

string                                          Deal note's content

 

To create a deal note, following permissions are required.

• Deal permission: the user should have a permission to manage deals.
• Pipeline-specific permission: the user should have a permission to manage the pipeline the deal belongs to.