API: Noter og aktiviteter (vises i Noter-fanen)
Når I opretter en note via API-nøgle (Bearer sb_...), skal den også dukke op i CRM-UI'ets Noter-fane — samme adfærd som når en bruger opretter noten i browseren.
Forudsætninger
- API-nøgle under Indstillinger → API & Webhooks → API-nøgler
- Et gyldigt entity-id (fx virksomhed) i jeres workspace
Opret note der vises i Noter-fanen
Brug POST /api/v1/notes — ikke kun POST /api/v1/activities.
POST /api/v1/notes
Authorization: Bearer sb_...
Content-Type: application/json
{
"company": "6a55528dc3d542762fda3221",
"title": "Kontaktdata",
"content": "…",
"source": "crm"
}
Hvad der sker
- Noten gemmes i notes-samlingen
- Salesbase opretter automatisk en aktivitet med
noteRef(ogcompanyRef/ anden entity-ref) - Noten vises under virksomhedens Noter-fane og i aktivitetsfeedet
I behøver ikke et ekstra kald til /api/v1/activities for at få noten synlig i UI'et.
Påkrævede felter
| Felt | Krav |
|---|---|
title | Påkrævet |
| Entity-ref | Mindst én: company, personRef, leadRef, dealRef eller customObjectRecord (+ customObjectSlug ved custom object) |
content og source er valgfrie.
Verificér
GET /api/v1/notes?company={id}— noten findesGET /api/v1/companies/{id}/activity-feed— indeholder note-aktivitet- I appen: åbn virksomheden → fanen Noter
Opdater og slet
| Metode | Effekt |
|---|---|
PUT /api/v1/notes/:id | Opdaterer noten og synkroniserer den linkede aktivitet |
DELETE /api/v1/notes/:id | Sletter noten og fjerner den linkede aktivitet |
POST /api/v1/activities (feed-rækker)
Brug dette endpoint når I vil oprette en generel aktivitet (ikke en fuld note-post).
Accepterede felter (ud over type):
summaryellertitle(mindst én påkrævet)descriptioncompanyId/personId/dealId/leadIdentityType+entityId(fxcompany+ id)noteRef— link til en eksisterende notedate,metadata
{
"type": "note",
"title": "Opfølgning",
"description": "Ringede uden svar",
"entityType": "company",
"entityId": "6a55528dc3d542762fda3221"
}
Tip: Vil I have en rigtig note i Noter-fanen, brug POST /api/v1/notes. activities alene opretter ikke automatisk en Note-dokument — den laver en feed-række.
Fejlsøgning
| Symptom | Løsning |
|---|---|
| Note findes via GET, men mangler i Noter-fanen | Kald er på gammel release uden activity-sync — opgrader; genopret noten via POST /api/v1/notes |
| 400 Missing entity reference | Send company (eller anden entity-ref) i body |
| 400 Missing title | title er påkrævet på notes |
Activities ignorerer title/entityType | Brug aktuelle API — felterne er understøttet; tjek at I rammer /api/v1/activities med JSON-body |
Relateret
- API og webhooks overblik
- API-reference
- Markdown:
GET /api/v1/docs/markdown