Contact Notes

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

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

Get a contact note

GET /c/api/v1/contacts/{contact_id}/notes/{id}

Returns a single note on the given contact. Requires contacts_read and the CRM module.

Path parameters

FIELDTYPEDESCRIPTION
contact_idstring · requiredId of the parent contact.
idstring · requiredId of the note.

Code samples

curl --request GET \
  --url 'https://api.cornerspot.net/c/api/v1/contacts/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/contacts/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/contacts/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/contacts/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/contacts/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/contacts/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

STATUSDESCRIPTION
200 OKthe note
401 Unauthorizedmissing or invalid API key
402 Payment Requiredthe team's plan doesn't include the CRM module
403 Forbiddenthe key lacks the contacts_read scope
404 Not Foundno such note (or note belongs to a different contact)

Delete a contact note

DELETE /c/api/v1/contacts/{contact_id}/notes/{id}

Soft-deletes a note. The note is no longer returned by index/show after deletion. Requires contacts_write and the CRM module.

Path parameters

FIELDTYPEDESCRIPTION
contact_idstring · requiredId of the parent contact.
idstring · requiredId of the note.

Code samples

curl --request DELETE \
  --url 'https://api.cornerspot.net/c/api/v1/contacts/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/contacts/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/contacts/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/contacts/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/contacts/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/contacts/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

STATUSDESCRIPTION
204 No Contentnote deleted
401 Unauthorizedmissing or invalid API key
402 Payment Requiredthe team's plan doesn't include the CRM module
403 Forbiddenthe key lacks the contacts_write scope
404 Not Foundno such note (or note belongs to a different contact)

Was this article helpful?