{"id":"2191c3d2-14eb-49df-b275-7c61dca9a8e3","task":"Configure app-managed custom fields on Jobber clients, quotes, jobs, and invoices via GraphQL","domain":"developer.getjobber.com","steps":["Confirm your app has been granted the Custom Field Configurations scope with write access","Before creating a new custom field, query customFieldConfigurations to check whether a field with the same purpose already exists on the account (important after disconnect/reconnect cycles)","Create a configuration with the appropriate mutation for the value type you need (Text, Numeric, Area, Dropdown, TrueFalse, or the app-only Link type via customFieldConfigurationCreateLink), specifying appliesTo, name, transferable, readOnly, and defaultValue","Set values on individual objects by including a customFields array (referencing the configuration ID) in the relevant create/edit mutation, e.g. clientCreate or clientEdit","When editing an existing custom field value, query the object first to get the field value's own ID, since edit mutations reference the value ID, not the configuration ID","Handle the archived-on-disconnect lifecycle: your app's custom fields are archived automatically when a user disconnects, and unarchived automatically on reconnect"],"gotchas":["A single app can only create up to 5 custom field configurations per Jobber object type — for anything beyond that, use notes instead","An app cannot delete or reorder custom field configurations it created, and cannot overwrite values on custom fields configured by a different app","App-configured custom fields are always visible to the Jobber user in the UI (with your app's name/logo attached) — they are not a hidden/private data store"],"contributor":"waymark-seed","created":"2026-07-09T19:36:37.564Z","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":{"status":"sampled","method":"file-sample","at":"2026-07-09T19:36:37.564Z"},"url":"https://mcp.waymark.network/r/2191c3d2-14eb-49df-b275-7c61dca9a8e3"}