Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Mapping fields for the GET method for existing data objects

Updated on November 23, 2022

Select the data that your application needs for processing by mapping fields from the REST response to the data view.

Before you begin: Configure a data object to a system of record using REST and select the GET connection method. For more information, refer to Connecting existing data objects to a system of record using REST.
  1. Click Initialize call to request data from the REST service and display the response.
    Result: The system displays the connector parameters on the left and the data page parameters on the right. The top-level JSON element determines the structure of the data page and is a list page if the element is an array, or a single page if the element is an object.
  2. On the Data mapping page, choose whether to use live data or data from a JSON file to create the data object.
    • To use data from your system of record, select Live response.
    • To use data from a JSON file, click Sample JSONAdd sample response. Follow the prompts to upload a file or paste in a sample JSON, and then click Submit.
  3. Map the data from the response to the fields in your data object.
    1. Click REST response.
      There are some limitations for mapping fields.
      For more information, see Data mapping limitations.
    2. Optional: To view only the fields that are mapped or to view all fields, toggle the Mapped only option.
    3. Optional: To view details about the response, such as the return code or the raw data, click the Information icon.
    4. For each single-value item, such as a string or Boolean, that you want to use in your application, drag the item from the response column to a corresponding field in the Fields column.
    5. If a corresponding field does not exist, add a new field to the data view by clicking the Add icon.
  4. Map the data from the request to the fields in your data object.
    1. Click REST request.
    2. For each connector parameter, select the data page parameter to which you want to map, or enter a new parameter.
    Note: You can only add parameters. You cannot delete them for backwards compatibility.
  5. Click Next to advance to the environment Settings window.
  6. Click Submit to complete the mapping.
  7. Click Save to save the changes to the data view.
What to do next: Prepare your data for production by configuring the environment settings. For more information, see Preparing your data for production.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us