---
schema_version: "1"
id: 6ac56c0d0cfeb5e6b363924d92e22fd11fdb2a1913446f025d081a14e1088f1b
title: Invoke Omnistudio Data Mappers
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/os_invoke_data_mappers.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_invoke_data_mappers.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 2f0f2d2b878e8a5764941f4acf99c847dd5b24f43421a86bc062774b3be954e7
description: Easy to build and reusable, you can call Data Mappers from other Omnistudio tools, such as Integration Procedures, Omniscripts, and Flexcards. But Apex classes, batch jobs, or REST APIs, can also call Data Mappers. With a Data Mapper, centrally manage data transactions to use in multiple applications.
products:
  - Omnistudio
release: "264"
---
# Invoke Omnistudio Data Mappers

Easy to build and reusable, you can call Data Mappers from other Omnistudio tools, such as Integration Procedures, Omniscripts, and Flexcards. But Apex classes, batch jobs, or REST APIs, can also call Data Mappers. With a Data Mapper, centrally manage data transactions to use in multiple applications.

For example, an organization receives regularly updated files with new user information in an XML format. They configure a Data Mapper Load to parse, transform, and load this XML data into multiple related Salesforce objects (such as Account, User, and Contact).

As another example, a Salesforce Flow creates or updates an Account, several related Contacts, and a custom Policy record at one time from user input. Rather than creating multiple steps in Flow, create a single Data Mapper Load to handle the entire multi-object upsert. A Flow can call a simple Integration Procedure that invokes the Data Mapper Load.

- **[Omnistudio Data Mapper REST API](https://help.salesforce.com/s/articleView?id=xcloud.os_dataraptor_rest_api_47730.htm&release=264.0.0&type=5)**  
    You can invoke any type of Data Mapper using the Data Mapper REST API. To update Salesforce objects using a Data Mapper Load, issue a POST request that includes a JSON payload that is formatted to comply with the input that the Data Mapper load expects. To retrieve data from Salesforce, issue a GET call to a Data Mapper Extract, specifying the Id or parameters identifying the data to be retrieved. The data is returned in the response in JSON format.
- **[Omnistudio Data Mapper Calls From Apex](https://help.salesforce.com/s/articleView?id=xcloud.os_dataraptor_calls_from_apex_47779.htm&release=264.0.0&type=5)**  
    Starting with Summer’ 25, to call a Data Mapper from Apex, call the ConnectApi.OmniDesignerConnect.executeDataMapper(bundleName, apexInput) Connect API specifying the name of the Data Mapper and the input data that it requires. This API replaces the vlocity\_ins.DRGlobal.processObjectsJSON() method. This Connect API removes the dependency on the managed package and provides up to 60% better performance for Data Mapper calls from an Apex class compared to the previous method.
- **[DRGlobal Class and Methods](https://help.salesforce.com/s/articleView?id=xcloud.os_drglobal_class_and_methods_47814.htm&release=264.0.0&type=5)**  
    Use the ConnectApi.OmniDesignerConnect.executeDataMapper(bundleName, apexInput) Connect API to call Data Mappers from Apex through the DRGlobal Apex class. Starting with Summer ’25, replace the existing methods in the DRGlobal Apex classes with the Connect API.