Skip to main content
GET
List notes
Returns every note attached to one person (Contact) or company (Company), which Salesfinity looks up from the identifiers you send. This is resolve-only: unlike Create a note, it never creates a record. If no contact or company on your team matches, it returns 404. The response is not paginated; it holds all of the record’s notes. Pinned notes come first, the most recently pinned at the top, followed by the rest newest first.

Query parameters

Person identifiers (type=person)

Supply at least one. They are tried in this order, and the first that matches wins.

Company identifiers (type=company)

Supply at least one. website_url is tried first.
URL-encode every value. A + in an E.164 phone number must be sent as %2B, or it arrives as a space and matches nothing. Query parameters not listed here, such as limit, are rejected with 400.

Example request

Response

Note object

Errors

Authorizations

x-api-key
string
header
required

Team-scoped API key generated in the Salesfinity dashboard under Settings → Connections → API & Webhooks. A missing or invalid key returns HTTP 403.

Query Parameters

type
enum<string>
required

Kind of record to look up: person (a contact) or company. Decides which identifier parameters apply.

Available options:
person,
company
Example:

"person"

linkedin_url
string

LinkedIn profile URL. Person only. The username after /in/ is what is matched.

Maximum string length: 500
Example:

"https://www.linkedin.com/in/janedoe"

email
string

Email address. Person only. Must be a valid email address. Matched exactly; Salesfinity stores emails in lowercase.

Maximum string length: 320
crm_id
string

The contact's record ID in your connected CRM, as Salesfinity imported it (for example a Salesforce Contact ID). Person only. Matched exactly.

Maximum string length: 200
Example:

"0035e00000AbCdEAAZ"

phone
string

Phone number in E.164 format, URL-encoded (%2B14155552671). Person only. Matched exactly against the contact's stored numbers.

Maximum string length: 50
Example:

"+14155552671"

website_url
string

Company website. Company only. Matched on its hostname, lowercased and without www..

Maximum string length: 500
Example:

"https://acme.com"

name
string

Company name. Company only. Matched case-insensitively against the whole name.

Maximum string length: 300
Example:

"Acme Corp"

Response

The resolved record and all of its notes.

type
enum<string>

The type you sent.

Available options:
person,
company
contact_id
string | null

ID of the contact the notes belong to. Present when type is person.

Example:

"6703f1c2a9e4b8d1c2f3a4b6"

company_id
string | null

ID of the company the notes belong to. Present when type is company.

Example:

"507f1f77bcf86cd799439012"

notes
object[]

Every note on the record, not paginated: pinned notes first (most recently pinned first), then the rest newest first.