API: Brugerdefinerede objekter

Brugerdefinerede objekter kan oprettes, opdateres og synkroniseres via REST API. Det gør det muligt at spejle branche-specifikke datatyper i jeres egne systemer uden manuel indtastning i UI.

Artiklen er til udviklere og integrationer der arbejder med custom objects og API-nøgler.

Forudsætninger

• API-nøgle med passende scopes oprettet under Indstillinger → API & Webhooks
• Kendskab til objektets slug (fx projekter eller licenser)

Scopes

Handling	Scope
Schema og felter (POST/PATCH/DELETE på definition)	admin
Records (CRUD, bulk)	write
Eksport/import af records	export / import + workspace-admin

Sådan gør du

1. Hent feltdefinitioner: GET /api/v1/custom-objects/:slug
2. Opret record: POST /api/v1/custom-objects/:slug/records med felt-slugs som keys i JSON
3. Opdater mange records: POST /api/v1/custom-objects/:slug/records/bulk
4. Abonner på ændringer via webhook-events custom_object.* (se webhook-guide)

Fuld reference findes på API-reference eller under Indstillinger → API & Webhooks → Dokumentation.

Resultat

Jeres middleware eller produktionsystem holder brugerdefinerede objekter synkroniseret med Salesbase i realtid eller on-demand.

Fejlsøgning

Symptom	Løsning
403 på schema-ændring	Brug API-nøgle med admin-scope
Ukendt felt i POST	Tjek slug mod GET definition. Felter er case-sensitive
Bulk fejler delvist	Læs fejl-array i response og ret enkelte records

Relateret

• API og webhooks overblik
• API: Webhook-events
• Styr Salesbase med AI-agenter