Create a Note activity

POST

https://api.close.com/api/v1/activity/note/

POST

/api/v1/activity/note/

curl -X POST https://api.close.com/api/v1/activity/note/ \
     -H "Content-Type: application/json" \
     -u "<CLOSE_API_KEY>:" \
     -d '{
  "lead_id": "lead_s6vHFTK1TSRoH6otXOexWDO9jM4xyb1kELHDoU7Fdsp",
  "attachments": [
    {
      "filename": "picture.gif",
      "url": "https://app.close.com/go/file/temporary/user_MvDoAZA889UMrgsZbnXmHkJSomSi7qk2Iwc4JnGHTbo/3HV4BNwDyBLdfrPbFZF78s/picture.gif/",
      "content_type": "image/gif"
    }
  ],
  "note_html": "<body><p>this is a test note.</p></body>"
}'

{
  "_type": "Note",
  "activity_at": "2013-02-20T06:39:57.266000+00:00",
  "attachments": [
    {
      "content_type": "image/gif",
      "filename": "picture.gif",
      "size": 20673,
      "url": "https://app.close.com/go/file/persisted/orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH/activity.note/acti_kwWA3rOfy4BnaZ8QQk3RIIAz51dU9ayiluy1s961Oiw/3HV4BNwDyBLdfrPbFZF78s/picture.gif/",
      "thumbnail_url": "https://app.close.com/go/file/persisted/orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH/activity.note/acti_kwWA3rOfy4BnaZ8QQk3RIIAz51dU9ayiluy1s961Oiw/3HV4BNwDyBLdfrPbFZF78s/picture.gif/thumbnail/"
    }
  ],
  "contact_id": null,
  "created_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
  "date_created": "2013-02-20T06:39:57.266000+00:00",
  "date_updated": "2013-02-20T06:39:57.266000+00:00",
  "id": "acti_kwWA3rOfy4BnaZ8QQk3RIIAz51dU9ayiluy1s961Oiw",
  "lead_id": "lead_s6vHFTK1TSRoH6otXOexWDO9jM4xyb1kELHDoU7Fdsp",
  "note": "this is a test note.",
  "note_html": "<body><p>this is a test note.</p></body>",
  "note_mentions": [],
  "organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
  "pinned": false,
  "pinned_at": null,
  "source": "api",
  "title": null,
  "updated_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
  "user_id": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
  "users": [],
  "created_by_name": "Bruce Wayne",
  "updated_by_name": "Bruce Wayne",
  "user_name": "Bruce Wayne"
}

To include an attachment, you must first upload the file to Close using the Files API. 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. 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.

Authentication

AuthorizationBasic

Use your API key as the username and leave the password empty.

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

lead_idstringRequired

activity_atdatetime or nullOptional

attachmentslist of objects or nullOptional

contact_idstring or nullOptional

created_bystring or nullOptional

date_createddatetime or nullOptional

notestring or nullOptional

note_htmlstring or nullOptional

organization_idstring or nullOptional

pinnedboolean or nullOptional

titlestring or nullOptional

user_idstring or nullOptional

Response

Successful response

_typestring

activity_atdatetime or null

attachmentslist of objects

contact_idstring or null

created_bystring or null

date_createddatetime

date_updateddatetime

idstring

lead_idstring or null

notestring

note_htmlstring

note_mentionslist of strings

organization_idstring

pinnedboolean

pinned_atdatetime or null

sourceenum or null

titlestring or null

updated_bystring or null

user_idstring or null

userslist of strings

agent_action_reasonstring or nullOptional

agent_config_idstring or nullOptional

comment_summaryobject or nullOptional

created_by_namestring or nullOptional

updated_by_namestring or nullOptional

user_namestring or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error