Notes

List notes

GET/api/v1/notes

Notes on one contact, company or deal, newest first.

Query parameters

Example request

curl "https://crowdstack.org/api/v1/notes?contactId=cmf3k2x9a0001abcd" \
  -H "Authorization: Bearer $CROWDSTACK_API_KEY"

Example response

{
  "notes": [
    {
      "id": "cmf3k2x9a0090abcd",
      "body": "Spoke to Jane; she wants the security questionnaire before renewal.",
      "author": {
        "id": "cmf3k2x9a0003abcd",
        "name": "Jane Doe",
        "email": "jane@acme-mail.com"
      },
      "contactId": "cmf3k2x9a0001abcd",
      "companyId": null,
      "dealId": null,
      "createdAt": "2026-09-15T10:12:00.000Z",
      "updatedAt": "2026-09-15T10:12:00.000Z"
    }
  ],
  "nextCursor": null
}

Add a note

POST/api/v1/notes

Adds a plain-text note to exactly one contact, company or deal. The note is attributed to the member behind the API key.

Request body

Responses

Example request

curl -X POST https://crowdstack.org/api/v1/notes \
  -H "Authorization: Bearer $CROWDSTACK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contactId": "cmf3k2x9a0001abcd",
    "body": "Spoke to Jane; she wants the security questionnaire before renewal."
  }'

Example response

{
  "note": {
    "id": "cmf3k2x9a0090abcd",
    "body": "Spoke to Jane; she wants the security questionnaire before renewal.",
    "author": {
      "id": "cmf3k2x9a0003abcd",
      "name": "Jane Doe",
      "email": "jane@acme-mail.com"
    },
    "contactId": "cmf3k2x9a0001abcd",
    "companyId": null,
    "dealId": null,
    "createdAt": "2026-09-15T10:12:00.000Z",
    "updatedAt": "2026-09-15T10:12:00.000Z"
  }
}

Delete a note

DELETE/api/v1/notes/:id

Permanently deletes a note.

Responses

Example request

curl -X DELETE https://crowdstack.org/api/v1/notes/cmf3k2x9a0001abcd \
  -H "Authorization: Bearer $CROWDSTACK_API_KEY"

Example response

{
  "deleted": true
}