Docs/Workspace API/Notes

Notes

Free-text notes attached to a contact, deal, or company. Every note must link to exactly one of these three (creating a note without any link returns HTTP 422). Body max 10,000 characters. Scopes: crm.notes.read / crm.notes.write / crm.notes.delete.

Endpoints

GET /api/workspace/v1/notes

GET /api/workspace/v1/notes/{id}

POST /api/workspace/v1/notes

PATCH /api/workspace/v1/notes/{id}

DELETE /api/workspace/v1/notes/{id}

POST /api/workspace/v1/notes/{id}/restore

POST /api/workspace/v1/notes/bulk-delete

Create a note

curl "https://app.staffifyai.com/api/workspace/v1/notes" \
  -X POST \
  -H "Authorization: Bearer sfy_wsp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "body": "Follow-up needed after Q4 kickoff — customer asked about SLA credit terms.",
    "crm_deal_id": 1024
  }'

List notes for a contact

curl "https://app.staffifyai.com/api/workspace/v1/notes?contact_id=1893" \
  -H "Authorization: Bearer sfy_wsp_live_YOUR_KEY"

Webhooks

note.created
note.updated
note.deleted
note.restored