Upsert object
Create or update a custom object by type and external id. The type must already exist. By default attributes is REPLACED wholesale — pass mode: 'merge' to add or change a subset without deleting the rest, and createMissing: false to update only when the object already exists.
Authorizations
Organization API key, sent as Authorization: Bearer boom_org_....
Body
The custom object type name. Must already exist (create it with the types endpoint) — unknown types are rejected.
1 - 255Your stable identifier for this object within its type (idempotency key).
1 - 255Human-readable label for the object.
1 - 255Free-form custom traits. Full-replace by default — omitted keys are deleted. Pass mode:'merge' to overlay only what you send.
How attributes is applied. 'replace' (default) swaps the whole blob — any stored attribute you leave out is DELETED. 'merge' overlays the keys you send onto the stored ones and leaves the rest untouched, which is what you want when adding or changing a subset.
replace, merge When false, objects that do not already exist are skipped and reported in skipped instead of being created. Use it when working from a list that may not match, so a bad id enriches nothing rather than inventing an object.