Opportunity Notes

Base URL: https://api.cornerspot.net

Authentication: requests use a bearer token, for example Authorization: Bearer YOUR_API_KEY.

List an opportunity's notes

GET /c/api/v1/opportunities/{opportunity_id}/notes

Returns a paginated list of notes for a given opportunity (deal), ordered by pinned (desc) then created_at (desc). Requires the opportunities_read scope and the CRM module.

Path parameters

FIELD	TYPE	DESCRIPTION
`opportunity_id`	string · required	The id of the opportunity whose notes are being listed or created.

Query parameters

FIELD	TYPE	DESCRIPTION
`page`	integer	1-based page number.
`per_page`	integer	Page size (1–100, default 25).

Code samples

curl --request GET \
  --url 'https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes' \
  --header 'Authorization: Bearer YOUR_API_KEY'

const response = await fetch('https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

// Node.js 18+ (native fetch)
const response = await fetch('https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status}`);
}

const data = await response.json();
console.log(data);

import json
import urllib.request

url = "https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}

request = urllib.request.Request(url, headers=headers, method="GET")

with urllib.request.urlopen(request) as response:
    data = json.loads(response.read().decode("utf-8"))
    print(data)

require "json"
require "net/http"

uri = URI("https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes")

request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts JSON.parse(response.body)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

$data = json_decode($response, true);
print_r($data);

Responses

STATUS	DESCRIPTION
`200` OK	a page of notes
`401` Unauthorized	missing or invalid API key
`402` Payment Required	the team's plan does not include CRM
`403` Forbidden	the key lacks the opportunities_read scope
`404` Not Found	no such opportunity in this team

Add a note to an opportunity

POST /c/api/v1/opportunities/{opportunity_id}/notes

Creates a note on the given opportunity. The note is owned by the authenticated user. Requires opportunities_write and the CRM module.

Path parameters

FIELD	TYPE	DESCRIPTION
`opportunity_id`	string · required	The id of the opportunity whose notes are being listed or created.

Request body

FIELD	TYPE	DESCRIPTION
`note`	object
`note.body`	string · required	Required — the main note content.
`note.title`	string	Optional short title for the note.
`note.pinned`	boolean	When true the note floats to the top of the list.
`note.tag_ids[]`	array of string	Ids of tags to attach.

Code samples

curl --request POST \
  --url 'https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
  "note": {
    "body": "string",
    "title": "string",
    "pinned": true,
    "tag_ids": [
      "1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d"
    ]
  }
}'

const response = await fetch('https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    "note": {
      "body": "string",
      "title": "string",
      "pinned": true,
      "tag_ids": [
        "1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d"
      ]
    }
  })
});

const data = await response.json();
console.log(data);

// Node.js 18+ (native fetch)
const response = await fetch('https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    "note": {
      "body": "string",
      "title": "string",
      "pinned": true,
      "tag_ids": [
        "1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d"
      ]
    }
  })
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status}`);
}

const data = await response.json();
console.log(data);

import json
import urllib.request

url = "https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes"
payload = json.dumps({
  "note": {
    "body": "string",
    "title": "string",
    "pinned": true,
    "tag_ids": [
      "1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d"
    ]
  }
}).encode("utf-8")
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY",
}

request = urllib.request.Request(url, data=payload, headers=headers, method="POST")

with urllib.request.urlopen(request) as response:
    data = json.loads(response.read().decode("utf-8"))
    print(data)

require "json"
require "net/http"

uri = URI("https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes")

request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer YOUR_API_KEY"
request.body = JSON.generate({
  "note": {
    "body": "string",
    "title": "string",
    "pinned": true,
    "tag_ids": [
      "1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d"
    ]
  }
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts JSON.parse(response.body)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Authorization: Bearer YOUR_API_KEY',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'note' => [
        'body' => 'string',
        'title' => 'string',
        'pinned' => true,
        'tag_ids' => [
            '1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d',
        ],
    ],
]),
]);

$response = curl_exec($curl);
curl_close($curl);

$data = json_decode($response, true);
print_r($data);

Responses

STATUS	DESCRIPTION
`201` Created	created
`401` Unauthorized	missing or invalid API key
`402` Payment Required	the team's plan does not include CRM
`403` Forbidden	the key lacks the opportunities_write scope
`404` Not Found	no such opportunity in this team
`422` Unprocessable Content	validation errors (e.g. missing required body)

Get an opportunity note

GET /c/api/v1/opportunities/{opportunity_id}/notes/{id}

Path parameters

FIELD	TYPE	DESCRIPTION
`opportunity_id`	string · required	The id of the opportunity.
`id`	string · required	The id of the note.

Code samples

curl --request GET \
  --url 'https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d' \
  --header 'Authorization: Bearer YOUR_API_KEY'

const response = await fetch('https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

// Node.js 18+ (native fetch)
const response = await fetch('https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status}`);
}

const data = await response.json();
console.log(data);

import json
import urllib.request

url = "https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}

request = urllib.request.Request(url, headers=headers, method="GET")

with urllib.request.urlopen(request) as response:
    data = json.loads(response.read().decode("utf-8"))
    print(data)

require "json"
require "net/http"

uri = URI("https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d")

request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts JSON.parse(response.body)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

$data = json_decode($response, true);
print_r($data);

Responses

STATUS	DESCRIPTION
`200` OK	the note
`401` Unauthorized	missing or invalid API key
`402` Payment Required	the team's plan does not include CRM
`403` Forbidden	the key lacks the opportunities_read scope
`404` Not Found	no such opportunity or note in this team

Delete an opportunity note

DELETE /c/api/v1/opportunities/{opportunity_id}/notes/{id}

Soft-deletes the note. Returns 204 No Content on success.

Path parameters

FIELD	TYPE	DESCRIPTION
`opportunity_id`	string · required	The id of the opportunity.
`id`	string · required	The id of the note.

Code samples

curl --request DELETE \
  --url 'https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d' \
  --header 'Authorization: Bearer YOUR_API_KEY'

const response = await fetch('https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

// Node.js 18+ (native fetch)
const response = await fetch('https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status}`);
}

const data = await response.json();
console.log(data);

import json
import urllib.request

url = "https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}

request = urllib.request.Request(url, headers=headers, method="DELETE")

with urllib.request.urlopen(request) as response:
    data = json.loads(response.read().decode("utf-8"))
    print(data)

require "json"
require "net/http"

uri = URI("https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d")

request = Net::HTTP::Delete.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts JSON.parse(response.body)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.cornerspot.net/c/api/v1/opportunities/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d/notes/1f2e3d4c-5b6a-4789-9c0d-1e2f3a4b5c6d',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

$data = json_decode($response, true);
print_r($data);

Responses

STATUS	DESCRIPTION
`204` No Content	deleted
`401` Unauthorized	missing or invalid API key
`402` Payment Required	the team's plan does not include CRM
`403` Forbidden	the key lacks the opportunities_write scope
`404` Not Found	no such opportunity or note in this team

List an opportunity's notes

Path parameters

Query parameters

Code samples

Responses

Add a note to an opportunity

Path parameters

Request body

Code samples

Responses

Get an opportunity note

Path parameters

Code samples

Responses

Delete an opportunity note

Path parameters

Code samples

Responses

Was this article helpful?