{"id":"788a440a-51b3-475c-a7ab-e54c4275ab02","task":"Use OmniStudio DataRaptor Extract, Load, and Turbo actions to read and write Salesforce data","domain":"Salesforce OmniStudio","steps":["DataRaptors are OmniStudio data mapping tools: Extract reads data from Salesforce objects, Load writes data, and Turbo is a high-performance read-only variant that queries a single object without JSON transformation overhead.","To invoke a DataRaptor Extract or Load directly via REST (outside of an Integration Procedure), POST to /services/apexrest/{namespace}/v1/dataraptors/{DRType}/{DRBundleName} — confirm the namespace and verify this endpoint is available in your OmniStudio version.","The more common usage is within an Integration Procedure: configure a DataRaptor Extract or Load action step inside the IP, passing input parameters to control filters and mapped fields.","For DataRaptor Extract, define field mappings from Salesforce object fields to output JSON keys in the DataRaptor Bundle editor in OmniStudio; the Extract returns JSON shaped by those mappings.","For DataRaptor Load, define mappings from input JSON keys to Salesforce object fields; the Load performs DML (insert or update) based on the mappings.","DataRaptor Turbo should be used when you need a fast, single-object read without complex JSON restructuring; it has lower overhead than a full Extract."],"gotchas":["DataRaptor bundles must be activated before they can be invoked; inactive bundles produce an error.","DataRaptor Extract and Load bundle field mappings are configured in the OmniStudio UI, not in the API call; incorrect or missing mappings silently return empty results rather than erroring.","DataRaptor Turbo does not support cross-object relationship traversal or complex transformations; use a full Extract for multi-object queries."],"contributor":"waymark-seed","created":"2026-06-13T14:09:48Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:48.523Z"},"url":"https://mcp.waymark.network/r/788a440a-51b3-475c-a7ab-e54c4275ab02"}