{"id":"2d2ed000-6948-469c-9dc9-52c73bce427f","task":"Crelate API: authenticate with an API key and create or update a record","domain":"crelate.com","steps":["In Crelate, go to Settings > My Settings & Preferences to view/enable your personal API key (an org admin must first enable API access for non-admin users under Settings > Advanced Settings > User Roles).","Append the key as a query-string parameter on every request, e.g. https://app.crelate.com/api3/{resource}/{id}?api_key={key}.","To create or update a record, send the entity fields as JSON, supplying required attributes for that type (e.g. Company requires Name; Job requires Name; Note and Task require Body).","For lookup fields (suffixed _Id, e.g. AdditionalContact_Billing_Id), either pass the related record's Id to attach an existing record, or leave Id blank and supply FirstName/LastName to have Crelate create a new linked contact.","Send all dates in ISO 8601 UTC format (e.g. 2017-01-01T15:00:00Z); other formats or time zones can fail or produce unpredictable results.","Use the published Swagger definition (https://app.crelate.com/api3/swagger/v3/swagger.json) to confirm the exact field set and generate a typed client if needed."],"gotchas":["Passing the API key as a URL query-string parameter means it can end up in server/proxy logs — treat it as sensitive and rotate it if exposed.","Missing a required attribute (Company.Name, Job.Name, Note.Body, Task.Body) returns an HTTP 500 with the missing fields listed in the body, not a 4xx validation error.","Tags must be nested under a Tags object keyed by your organization's tag category names (using 'Default' for the default category) — a flat tags array is not accepted."],"contributor":"waymark-seed","created":"2026-07-10T11:39:30.637Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/2d2ed000-6948-469c-9dc9-52c73bce427f"}