--- title: "RevSure Salesforce Custom Object Writeback Guide" slug: "revsure-salesforce-custom-object-writeback-guide" description: "Configure RevSure Salesforce custom object mappings, select an External ID for upserts, sync changes, and write mapped data back during scheduled syncs." tags: ["Salesforce Custom Objects", "External ID Mapping", "Data Writeback"] updated: 2026-10-30T16:52:58Z published: 2026-10-30T16:52:58Z canonical: "documents.revsure.ai/revsure-salesforce-custom-object-writeback-guide" --- > ## Documentation Index > Fetch the complete documentation index at: https://documents.revsure.ai/llms.txt > Use this file to discover all available pages before exploring further. # RevSure Salesforce Custom Object Writeback Guide Adding Custom Object Write Back in RevSure Salesforce Data Source Mappings Configure Salesforce custom objects and attribute mappings so RevSure can write data back during scheduled syncs. # 1. Add the Salesforce custom object Navigate to Data Sources > Salesforce > Mappings. Click Add Object, search for the custom Salesforce object, select it, and click Apply. ![](https://cdn.document360.io/1ba0d15e-f1ca-43db-aba7-8e6b7d8766f9/Images/Documentation/image(959).png) *Figure 1. Select the Salesforce object using Add Object.* # 2. Choose access and the RevSure entity In the confirmation dialog, select Read only, Write only, or Read + Write. Select the RevSure entity that will provide the data for write back (for example, Account or Lead), then click Update. ![](https://cdn.document360.io/1ba0d15e-f1ca-43db-aba7-8e6b7d8766f9/Images/Documentation/image(960).png) *Figure 2. Configure access and select the source RevSure entity.* # 3. Verify and select the External ID Return to the Mappings page and open the Write To Source mapping for your object. An External ID field is required for upsert write back. When exactly one eligible External ID field is available, it appears in the Salesforce attribute mapping. When the Salesforce object has multiple External ID fields, choose the one relevant to this writeback from the Salesforce Attributes dropdown. Select the field that uniquely identifies the corresponding RevSure records and is populated consistently. ![](https://cdn.document360.io/1ba0d15e-f1ca-43db-aba7-8e6b7d8766f9/Images/Documentation/image(961).png) *Figure 3. Choose the relevant External ID when multiple external IDs exist.* | **Important:** If the Salesforce custom object does not have an External ID field, add and configure one in Salesforce before proceeding with upsert write back. Ensure the field is suitable for uniquely matching records and map it to the appropriate RevSure identifier. | | --- | # 4. Configure attribute mappings For each field to write back, select the RevSure attribute on the left and its corresponding Salesforce attribute on the right. Use Add Attribute to configure additional field mappings. Verify that the selected fields have compatible values and intended meanings. ![](https://cdn.document360.io/1ba0d15e-f1ca-43db-aba7-8e6b7d8766f9/Images/Documentation/image(962).png) *Figure 4. Map RevSure attributes to Salesforce fields, including the External ID.* # 5. Save the mappings After reviewing the mapping rows, click Save Mapping at the bottom right of the page. # 6. Sync the mappings In the mapping synchronization dialog, select Keep existing data and click Sync Mappings. This retains the existing RevSure data while adding data from the updated mappings in the next sync. ![](https://cdn.document360.io/1ba0d15e-f1ca-43db-aba7-8e6b7d8766f9/Images/Documentation/image(963).png) *Figure 5. Keep existing data and sync the updated mappings.* # 7. Write data back on subsequent syncs Once configured and synced, RevSure writes mapped data to the selected Salesforce custom object during each applicable sync. The selected External ID is used to match records for upsert, while the attribute mappings determine which values are written. | **Reminder:** Verify Salesforce field permissions and that the integration has write access to the selected object and fields. External ID configuration is mandatory for upsert write back. | | --- | ## Related - [Linkedin Audience Update Agent](/linkedin-audience-update-agent.md) - [Review Mapping](/review-mapping-19.md) - [Write To Source](/write-to-source-1.md)