At a glance
Object access
BenefitFlow also reads each object’s field list so your admin can map fields in Integration Settings.
When BenefitFlow writes a record, it can set the record owner, the parent account for contacts, and the parent account for child accounts.
What BenefitFlow stores
To match records, BenefitFlow keeps a copy of your accounts, contacts, active users and up to 100,000 opportunities. The copy includes every field the integration user can see. That’s the main reason to connect as a dedicated integration user with only the access below. Connection tokens are stored in our database, which is encrypted at rest. A small number of BenefitFlow administrators can view synced records to support your account.System permissions
The connecting user needs:- API Enabled (system permission)
- Read and create/edit on the objects in the table above
- OAuth scopes on your app. BenefitFlow requests api (read and write records) and refresh_token (stay connected without logging in again). If you create your own app, the manual setup steps also select the identity URL scope
Hiding sensitive fields
You can hide fields from the integration with field-level security. BenefitFlow skips hidden fields when it reads. Keep these visible:- Website, Email, Billing City and Billing State. BenefitFlow matches on them. Hiding them causes errors or duplicate records.
- Every field BenefitFlow writes to. That includes default fields like Title and Mailing State, not only fields your admin mapped. If one is hidden or read-only, the write fails for that record.
- Standard Opportunity fields. BenefitFlow reads a fixed set, so hiding one stops the weekly Opportunity read.
Recommended: a dedicated integration user
Connect as a dedicated integration user, not a person’s own login. The connection then keeps working when someone leaves, and you control exactly what it can see and change.- Create a user for BenefitFlow.
- Give it a permission set with API Enabled and the object access above. Nothing more.
- Hide any fields you don’t want shared, keeping the ones listed above.
- Log out of Salesforce, log back in as the integration user, then connect from BenefitFlow.
Network and allowlisting
All calls to your Salesforce org come from BenefitFlow’s servers, not from users’ browsers. The only browser step is the one-time login during setup.
If your org restricts API access by IP, adding this address is all you need.
API usage
What BenefitFlow calls, and when:- First sync. Reads your accounts and contacts in pages of 2,000 and stores a copy so it can tell you which records you already have.
- After that. Up to 4 times a day, reads only accounts and contacts changed in the last 5 days. It skips the read when nothing has changed.
- Daily. Refreshes active users, record counts, field lists and your duplicate and validation rules.
- Weekly. Reads up to 100,000 opportunities, standard fields only.
- When your team pushes records. Looks up only the records being pushed, then creates or updates them, up to 200 records per API call.
- Scheduled enrichment. If your admin sets up enrichment, BenefitFlow checks every 3 hours and updates the fields you mapped.
How records are matched
By default, BenefitFlow matches on values your org already has, so you don’t need a BenefitFlow ID field:- Accounts match on website domain. Child accounts also match on billing city and state.
- Contacts and leads match on email.

