Salesforce Integration

Recurly's Salesforce integration links your Recurly account directly to your Salesforce Organization and automatically updates Subscription, Invoice, Transaction and Account data. Data recently added or updated within Recurly synchronizes with Salesforce every 4-6 hours.

We’ve made some improvements to our salesforce connector and we have a new version available for download. There are a number of improvements around invoice detail, VAT/Tax Breakout, Invoicing information, and a new object for invoice line items. Please see the detail on the new fields such as Invoice Fields and Invoice Line Items.


The Salesforce integration only works with Developer, Enterprise, and Unlimited editions of Salesforce. It does not work with Salesforce Sandboxes.

This feature is available in the Professional edition of Recurly. You may configure and test the Salesforce integration before your site is in live mode.

Setup and Configuration

  1. If you don’t already have a Salesforce account, you may create a free developer account for evaluation.

  2. Install the Recurly package to your Salesforce Organization. Once installed:

    a. From inside of Salesforce, click your name in the upper right and click Setup.

    b. Under Build, click Accounts and then Fields.

    c. For each field from the Recurly package as well as Account Number, click the field name.

    d. Click Set Field-level Security and set it to Visible for all users. Click Save.

    e. Then go to Page Layouts and edit your active layouts.

    d. Create a section called “Recurly Information” and drag all of the Recurly-related fields into this section.

  3. In Recurly, under Salesforce, click the Connect to Salesforce button and grant Recurly access to your Salesforce organization.

  4. The Recurly package extends the Account table with Recurly specific columns and adds 3 new tables: Invoice, Subscription, and Transaction. The Recurly-specific columns and tables are scoped under the Recurly namespace so they will not interfere or collide with other packages installed in your Salesforce organization.

  5. Once you’ve connected your Salesforce account to Recurly, all of your historical data will begin to sync to Salesforce. This process can take up to 24 hours depending on the amount of data inside your Recurly account.

  6. You can monitor the status of the data synchronization by following the instructions here:

The Recurly Package Schema

Account Matching

The Recurly Salesforce app adds a field called “recurly__Account_Code__c” to match accounts.

By setting this field on your Salesforce accounts before they are created inside Recurly, the Recurly Salesforce integration checks for all recurly__Account_Code_c values before pushing up data. Based on the presence of data in that field, the Salesforce integration will create or update those matching records.


Recurly synchronizes your accounts with the following fields in the Account table:

These fields are added to your Account table specifically for Recurly records:


Invoice is a Recurly specific table added by the Recurly package. It contains the following fields:

Version 1.14 and later:

Manual Invoicing Updates:

Additional Amount fields:

New in Version 1.14: Invoice Items

*Note, invoice items have a lookup to Invoice but are not master-detail. While we are only syncing invoiced charges at this time, we may sync uninvoiced charges in the future


Subscription is a Recurly specific table added by the Recurly package. It contains the following fields:


Transaction is a Recurly specific table added by the Recurly package. The Transaction table will only include transactions linked to accounts. It will not include failed payment or authorization attempts before an account successfully signs up. It contains the following fields:

Person Accounts

Recurly’s Salesforce integration can be configured to use Salesforce Person Accounts if they are enabled in your salesforce account. Please contact to have syncing to Person Accounts enabled. If you have Person Accounts enabled, our integration will default to use those when you first connect to Salesforce.

Please note that when you move from syncing from Standard Accounts to Person Accounts, the integration will create Person Accounts for the first time to sync all data. You’ll want to delete any Standard Accounts to ensure the data isn’t duplicated.


If you are experiencing any trouble with your Salesforce synchronization, please follow these instructions to check the status of Recurly bulk imports. If the bulk imports report any errors, please send them to the Recurly support team.