> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withorb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sync Orb data to Salesforce

Give your team full visibility into customer subscription data directly in Salesforce. By syncing billing and usage data from Orb, sales and success teams can track account health, identify expansion opportunities, and anticipate customer needs.

Monitor key business metrics including:

* Current subscriptions and product usage
* Invoice history and month-over-month trends
* Real-time usage patterns for upsell opportunities
* Credit balance and commitment tracking

## How it works

The Salesforce CRM integration creates a set of custom objects in Salesforce corresponding to Orb resources, as detailed below.

After successfully authenticating a Salesforce instance, the initial sync will export all existing Orb data into Salesforce. After the initial sync, objects will be incrementally synced on a daily basis.

| Orb resource                                                                        | Salesforce custom object name | Description                                                                                                                                                                                                        |
| ----------------------------------------------------------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [Customers](/core-concepts#customer)                                                | OrbCustomer                   | Representation of a business which includes name, address, and other information identifying the billable entity ([schema](/integrations-and-exports/salesforce/schema#customer))                                  |
| [Invoice](/core-concepts#invoice)                                                   | OrbInvoice                    | Issued invoices for the customer if the subscription is still active. Each invoice includes line items and finalized usage and dollar value totals ([schema](/integrations-and-exports/salesforce/schema#invoice)) |
| [Plan](/core-concepts#plan-and-price)                                               | OrbPlan                       | A group of prices representing what customers could be charged ([schema](/integrations-and-exports/salesforce/schema#plan))                                                                                        |
| [Subscription](/core-concepts#subscription)                                         | OrbSubscription               | The link between a plan and a specific customer. Including any overrides to a plan ([schema](/integrations-and-exports/salesforce/schema#subscription))                                                            |
| [Invoice Line Item Billing](/data-exports/resource-types#invoice-line-item-billing) | OrbInvoiceLineItemBilling     | The issued and billed amounts for each line item on an invoice ([schema](/integrations-and-exports/salesforce/schema#invoice-line-item-billing))                                                                   |
| [Subscription Version](/api-reference/subscription/fetch-subscription-schedule)     | OrbSubscriptionVersion        | A point in time representation of a plan for a particular customer ([schema](/integrations-and-exports/salesforce/schema#subscription-version))                                                                    |
| [Daily Line Item Revenue](/data-exports/resource-types#daily-line-item-revenue)     | OrbDailyLineItemRevenue       | The daily incremental changes on a line item representing the quantities each day for an invoice ([schema](/integrations-and-exports/salesforce/schema#daily-line-item-revenue))                                   |
| [Credit Ledger Entry](/product-catalog/prepurchase#exporting-the-ledger)            | OrbCommittedLedgerEntry       | Information on credit increments, decrements and voids ([schema](/integrations-and-exports/salesforce/schema#committed-ledger-entry))                                                                              |

For schema object information refer to the [schema page](/integrations-and-exports/salesforce/schema).

<img src="https://mintcdn.com/orb-9bba378a/w7VuLoqrCaLK7or4/images/salesforce_custom_objects.png?fit=max&auto=format&n=w7VuLoqrCaLK7or4&q=85&s=42fad836e6a26acc98b0220559bf23ce" alt="Salesforce custom objects" width="3446" height="1146" data-path="images/salesforce_custom_objects.png" />

## Setup

1. Navigate to the Integrations page under Settings.
2. Click "Connect to Salesforce" to configure the data sync.
   <img src="https://mintcdn.com/orb-9bba378a/w7VuLoqrCaLK7or4/images/salesforce_connect_button.png?fit=max&auto=format&n=w7VuLoqrCaLK7or4&q=85&s=81d4932e64ac6beb81829d332324f460" alt="Salesforce connect button" width="2422" height="408" data-path="images/salesforce_connect_button.png" />
3. Authorize Orb to connect to your Salesforce instance.
   <img src="https://mintcdn.com/orb-9bba378a/2A5OiQ38Rzt8eVDS/images/orb_census_connection.png?fit=max&auto=format&n=2A5OiQ38Rzt8eVDS&q=85&s=88ac6685e7354bed8857c4afb1ea04bd" alt="Orb census connection" width="2224" height="1426" data-path="images/orb_census_connection.png" />
4. After a successful connection, you can configure the sync.
   <img src="https://mintcdn.com/orb-9bba378a/81AJlpHJ0tfWnzrL/images/crm_configuration_required.png?fit=max&auto=format&n=81AJlpHJ0tfWnzrL&q=85&s=8aaa0627d9f680728968d7d343adf25f" alt="CRM configuration required" width="2416" height="510" data-path="images/crm_configuration_required.png" />

### Sync configuration

Orb allows configuring the data types exported to Salesforce. Orb recommends syncing a smaller set of objects to avoid data limit restrictions in Salesforce. Once the selection has been submitted, Orb will begin the initial sync process to create the objects in Salesforce and begin syncing over the Orb objects. The data type selection can be modified once the integration is active.

<img src="https://mintcdn.com/orb-9bba378a/81AJlpHJ0tfWnzrL/images/crm_configuration_dialog.png?fit=max&auto=format&n=81AJlpHJ0tfWnzrL&q=85&s=166efd16c4f33f5aee11386b9a7ab4c2" alt="CRM configuration dialog" width="3012" height="1742" data-path="images/crm_configuration_dialog.png" />

### Viewing Data in Salesforce

Navigate to the Reports tab in Salesforce to view the synced data.

<img src="https://mintcdn.com/orb-9bba378a/mmAvm-wURvmz4Fz_/images/subscription_usage.png?fit=max&auto=format&n=mmAvm-wURvmz4Fz_&q=85&s=22e528b4f8beef437a964f3b888b832c" alt="Subscription usage" width="3456" height="1716" data-path="images/subscription_usage.png" />
