Remote Fields | Overview

Learn a general overview of each category

Pritak Patel avatar
Written by Pritak Patel
Updated over a week ago

Availability

Remote Fields is currently in Closed Beta for:

Please reach out if you're looking for support in additional categories;

Terminology

  • Remote Model - An entity on a CRM provider.

    • Example: A Deal on Hubspot is a Remote Model.

  • Remote Source Model - A Remote Model which maps to a Merge Common Model.

    • Example: A Deal on Hubspot is the Remote Source Model of the Opportunity Merge Common Model.

What are Remote Fields?

Where supported, Merge syncs and maps all fields from Remote Source Models in a standardized format, as fields on relevant Merge Common Model instances. This includes both standard and custom (user-defined) fields.

Merge also surfaces metadata about each Remote Field. This includes:

  • Information about the field type - string, bool, number, etc.

  • More granular information about string formats, if applicable - UUID, email, phone number, etc.

  • If applicable, available options - for picklists and other enumerations.

  • UX-related Metadata, like display name.

  • Whether the field is custom to the account, or standard to the 3rd-party provider

What can I do with Remote Fields?

With Remote Fields, you can:

  • Pull metadata and values for all fields from Remote Source Models in a standardized format, including standard and custom fields

    • Endpoint for reading Remote Field Classes from a Common Model : GET https://api.merge.dev/api/crm/v1/{common_model_name}/remote-field-classes

    • Endpoint for reading Remote Field Classes and values from Common Model instances: GET https://api.merge.dev/api/crm/v1/{common_model_name}?include_remote_fields=True

    • Endpoint for reading Remote Field Classes and values from a particular Common Model instance: GET https://api.merge.dev/api/crm/v1/{common_model_name}/{id}?include_remote_fields=True

  • Push values for custom fields to your end-users’ CRM systems

    • You will use the relevant Merge POST endpoint for a particular Common Model, with your desired remote field values included in your request body.

    • Note: For pushing values for standard fields, you will use the standard Merge common model fields, or if needed, Linked Account parameters or Integration parameters.

Did this answer your question?