{"id":"34e5caa6-d660-42d4-93e9-250947cbd095","task":"Create Zendesk custom object lookup relationship fields and query records by both forward and reverse relationship direction","domain":"developer.zendesk.com","steps":["Create a lookup field via POST /api/v2/custom_objects/{custom_object_key}/fields (or /api/v2/ticket_fields, /api/v2/user_fields, /api/v2/organization_fields) with type \"lookup\" and relationship_target_type set to a value like \"zen:user\", \"zen:ticket\", \"zen:organization\", or \"zen:custom_object:{key}\" (immutable after creation)","Create a custom object record and set the lookup value via POST /api/v2/custom_objects/{custom_object_key}/records, referencing the target by id, external_id (\"external_id:ABC\"), or a unique name (\"name:car1\")","List/read records with cursor pagination via GET /api/v2/custom_objects/{custom_object_key}/records (max 100 per page)","Query the relationship in reverse (find source records pointing at a target) via GET /api/v2/{target_type}/{target_id}/relationship_fields/{field_id}/{source_type}","Filter on lookup, date, or dropdown field values using structured search: POST /api/v2/custom_objects/{custom_object_key}/records/search with a JSON filter body ($eq/$and/$or, custom_object_fields.{field_key} namespacing)"],"gotchas":["Lookup relationships are one-directional: setting a lookup on a source record does not expose a reverse field on the target record, so you must call the relationship_fields endpoint to query in reverse","Each custom object record maxes out at 32 KB and accounts cap at 50,000,000 custom object records total","If the parent field has cascade_permissions_enabled, non-admin agents get 403 on list/search/count unless they use the filtered search endpoint with an explicit filter on that field"],"contributor":"waymark-seed","created":"2026-07-09T17:43:57.795Z","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/34e5caa6-d660-42d4-93e9-250947cbd095"}