Set CRM Custom Field Values
custom_field_values_setSets a store's CRM custom field values. Takes the app_id returned by
apps_list, the store's shop_domain (e.g. "acme.myshopify.com"), and
values: an object keyed by the definition handle returned by
custom_fields_list.
Each value must fit its field's type: a number for number, true/false
for boolean, one of the field's options for select, a
YYYY-MM-DD string for date, an object or array for json. null
clears a field, which deletes its stored value.
Only the handles you send are touched; every other field on the store
keeps its value. At most 20 handles per call.
An unknown handle, or a value that does not fit its field, fails the whole call and writes nothing. Returns the store's full set of values after the write.
Writes are accepted for a store the CRM has not mirrored from Shopify
Partner events yet. Setting a value fires the custom_field.changed
automation trigger, once per field whose stored value actually changed.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"app_id": "<app_id>",
"shop_domain": "<shop_domain>",
"values": "<values>"
},
"name": "custom_field_values_set"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app_id | Yes | The app uuid returned by `apps_list`. | |
| values | Yes | Values keyed by custom field handle, from `custom_fields_list`. A null value clears the field. At most 20 entries. | |
| shop_domain | Yes | The store's myshopify domain, e.g. "acme.myshopify.com". | |
| organization_id | No | An organisation uuid or slug. When supplied, `app_id` is resolved within that organisation and may be a slug instead of a uuid, mirroring the Meridian web app. |