Skip to Content
IntegrationsCRM / PSA

Salesforce

Cotillion's Salesforce integration syncs Opportunities with their Products (line items) and Contact Roles, Accounts, Contacts, and the Notes, Tasks and Events on each opportunity and account from your Salesforce org into a single, standardised deal record. Once synced, the deals appear in your Cotillion workspace where you can register them against vendor portals (AWS Partner Central, Microsoft Partner Center, …) with a single action.

Your data is read-only to us. Cotillion never creates, edits or deletes a record in your org. What you add to the org is one managed package, Cotillion: the app Cotillion signs in through, the change events that tell Cotillion when a record changes, and a checkbox for hiding an opportunity from the sync, with a permission set that opens it to your team. The app signs in as an integration user whose permission set grants Read alone, so Salesforce refuses any edit there.

Before you begin: you'll install the Cotillion package, create a read-only permission set and an integration user, and let the package's app sign in as that user. You need a Salesforce administrator, and the whole setup takes about 15 minutes.

At a glance

ItemValue
PackageManaged package Cotillion (namespace cotillion), installed from a link
AuthenticationOAuth 2.0 client credentials through the package's app, signed in as your integration user – you enter only your My Domain URL
API surfaceSalesforce REST API on your org's My Domain, and change events over Salesforce's Pub/Sub API
DirectionRead-only
CredentialsNone from you: no key or secret is entered, and Cotillion stores only your org's address
API usageA small share of your org's daily API request allowance, shared with your other integrations
EditionsEnterprise, Performance, Unlimited and Developer

Setup

Step 1: Install the Cotillion package

  1. Sign in to Salesforce as an administrator.

  2. Open this address, with your org's own My Domain in front (Setup → Company Settings → My Domain shows it as the Current My Domain URL):

    https://<your-domain>.my.salesforce.com/packaging/installPackage.apexp?p0=04tQE00000kYqxlYAC

  3. Choose Install for Admins Only and click Install.

When it finishes, Setup → Installed Packages lists Cotillion with the namespace prefix cotillion. The package adds:

  • The Cotillion app – the External Client App Cotillion signs in through. Its key stays with Cotillion: your org holds no secret for it. In Step 4 you choose the user it signs in as.
  • Change events for Opportunity, Opportunity Product, Opportunity Contact Role, Account and Contact (the channel Cotillion Changes), so Salesforce tells Cotillion about each change as it happens.
  • The Cotillion Exclude From Sync checkbox on opportunities (Step 7).
  • The permission set Cotillion Exclude From Sync, which lets a user see and tick that checkbox (Step 7). Keep it off the integration user: its read access is the permission set you create in Step 2.

Change events cover five objects per org unless you hold Salesforce's Change Data Capture add-on licence; an object selected in several channels counts once. The package selects five. If your org already selects other objects for change events (Setup → Change Data Capture), they and the package's five must fit within that allowance, or the add-on licence is needed.

Step 2: Create a read-only permission set

The integration user in Step 3 sees only what this permission set grants.

In Salesforce Setup, open Users → Permission Sets and click New.

  1. Label: Cotillion Read Only. License: Salesforce API Integration. Save.
  2. Object Settings – grant Read and View All Fields on each object Cotillion reads, and View All Records where Salesforce offers it:
    • Opportunities, Accounts, Contacts – Read, View All Records, View All Fields. View All Fields on Opportunities also lets the integration user read the package's Cotillion Exclude From Sync checkbox.
    • Opportunity Products – Read on every field, so each line shows its total, list price, product code, description and date (View All Fields on Opportunities does not open them).
    • Products and Price Books – Read, View All Fields (Salesforce offers View All Records on neither, and Cotillion does not need it).
    • Tasks – Read on the fields Related To, Name, Comments and Due Date; Events – Read on Related To, Name, Description, Start and Due Date Only – so each activity shows which deal it belongs to and what it says.
  3. System Permissions – Access Activities (opens Tasks and Events to the user) and View All Users (resolves each opportunity's owner and each note's author to a name).
  4. Grant nothing else – no Edit, Create or Delete anywhere.

Step 3: Create the integration user

  1. Open Users → Users and click New User.
  2. User License: Salesforce Integration. Profile: Minimum Access - API Only Integrations. Give it a username such as cotillion.integration@<your-company>, and an email address of yours. Save.
  3. On the user's page, in the Permission Set License Assignments related list, click Edit Assignments, select Salesforce API Integration and save. The permission set from Step 2 needs this licence.
  4. Open Users → Permission Sets → Cotillion Read Only, click Manage Assignments, then Add Assignment, select the integration user and assign the set.

An API-only integration user cannot sign in to Salesforce's web app. Enterprise, Unlimited, Performance and Developer Edition orgs include a few Salesforce Integration licences at no extra cost; more can be bought.

Step 4: Let the Cotillion app sign in as the integration user

  1. From Setup, open External Client App Manager and click Cotillion – the app the package installed.
  2. On the Policies tab, click Edit.
  3. Under OAuth Flows and External Client App Enhancements, tick Enable Client Credentials Flow, and in Run As (Username) enter the username of the integration user from Step 3.
  4. Save. Leave every other policy as it is.

If Salesforce answers Enter a valid execution user for the OAuth client credentials flow, the username does not name an active user: check it for a typo.

Step 5: Copy your My Domain URL

Open Setup → Company Settings → My Domain and copy your Current My Domain URL, for example https://yourcompany.my.salesforce.com. The address in your browser while you are signed in to Salesforce works too: Cotillion reads your My Domain from either.

Step 6: Connect in Cotillion

  1. Sign in to your Cotillion workspace at cotillion.indyrct.com.
  2. Open CRM / PSA in the sidebar → Connect → Salesforce CRM.
  3. Enter the My Domain URL from Step 5. Nothing else is asked: there is no key or secret to paste.
  4. Click Test & Connect.

What happens automatically:

  • Cotillion signs in at your org's own address through the Cotillion app, as the integration user.
  • Verifies the setup by reading one opportunity.
  • Checks that Salesforce sends change events for each object the package selected.
  • Starts a one-time backfill sync, then keeps your deals up to date as Salesforce announces changes.

Step 7 (optional): Exclude individual opportunities from the sync

Some opportunities should never appear in Cotillion: internal-only forecasts, experiments, or deals you don't want surfaced for vendor registration. The package added a checkbox for this, Cotillion Exclude From Sync, to opportunities. Installed for admins only, it starts out visible to administrators alone.

  1. Give the people who decide this access to the field: open Users → Permission Sets → Cotillion Exclude From Sync, click Manage Assignments, then Add Assignment, select those users and assign the set.
  2. Add the field to the page layout they use: Object Manager → Opportunity → Page Layouts, open the layout, drag Cotillion Exclude From Sync from the palette into the opportunity's details and Save.
  3. Tick it on any opportunity you want hidden.

Salesforce tells Cotillion about the change at once, and the opportunity leaves your Deals within about 5 minutes. You can rename the field's label: Cotillion reads the field by the name the package gave it, which does not change.

Reversible. Un-tick the field to re-include the opportunity within about 5 minutes. Cotillion does not delete previously-synced deal data when you tick it: it stops refreshing it, and un-ticking brings the data back up to date.

How the sync works

CadenceWhat
Record changesAnnounced by Salesforce change events: a change to an opportunity, its products or contact roles, an account or a contact reaches Cotillion within seconds, and Cotillion re-reads just that record. A periodic full pass catches anything an event missed.
Opportunity syncEvery 5 minutes per organisation: announced changes are built into your deals, and notes and activities are read – Salesforce sends no change event for a Task, an Event or a Note.
Deletion detectionA deleted opportunity is announced and leaves your Deals after a short grace window; a deleted note is retired within about an hour.
Reference data refreshPeriodically: Cotillion refreshes your users, used to resolve opportunity owners and note authors to their names.

Salesforce meters every org by a daily API request allowance that all of your integrations share. Cotillion paces its requests and stays within a small share of it; if the allowance is ever spent, the sync waits until Salesforce frees requests again and then catches up. Change events arrive under your org's daily event delivery allocation; if that is ever spent, Cotillion picks up where it stopped once Salesforce delivers again, and Salesforce keeps change events for 72 hours.

Which opportunities Cotillion keeps

Cotillion keeps the opportunities you could register with a vendor, and the ones it is already tracking. In practice:

  • Open opportunities are synced and appear in Deals.
  • An opportunity that closes while Cotillion is tracking it stays. That is exactly when the outcome has to reach the vendor, when the vendor's verdict comes back, and when a won deal becomes eligible for an incentive. It moves out of the "requires action" view and stays under the registered deals.
  • Opportunities that were already closed before Cotillion saw them are not kept. Editing an old closed opportunity in Salesforce does not pull it in either. Your closed deal history stays in Salesforce.

What gets synced and how it stays stable

Each opportunity becomes the deal you see under Deals in Cotillion: its account, contacts, products and notes, with stages and owners as you use them in Salesforce.

  • Line items are the opportunity's products, as the opportunity's amount totals them, each with its product's name, code, family and description.
  • Contacts are everyone the opportunity's contact roles name, and the opportunity's own contact; the role marked primary is the deal's main contact.
  • Notes are the classic Notes, Tasks and Events on the opportunity and on its account, archived activities included. One you delete leaves Cotillion too, usually on the next sync and always within the hour. Enhanced Notes (the Notes tool of Lightning Experience) are not synced, and a private classic Note stays hidden from the integration user.
  • Custom fields on these objects come through as long as the permission set lets the integration user read them.

Two guarantees Cotillion holds across syncs:

  • Customer and contact identity are stable. When you rename an account in Salesforce, Cotillion picks up the new name on the next sync, but the same customer keeps the same internal identity: every opportunity that pointed to it before still points to it after. The same applies to contacts: a contact appearing on several opportunities is recognised as one person, not duplicated per opportunity.
  • Disconnect-then-reconnect is non-destructive. If you remove the Salesforce integration in Cotillion and add it back within 30 days, your existing opportunities re-attach to the new connection without losing their vendor-registration history or per-line-item state.

Deletions stay in step, too. Close an opportunity (Won/Lost) or remove a product line in Salesforce, and Cotillion reflects it within about 5 minutes. A deleted opportunity goes through a short grace window before it leaves your Deals, so a brief Salesforce hiccup can never wrongly wipe a live deal's registration history.

Disconnecting in Cotillion stops every read at once. To remove what the package added as well, uninstall Cotillion from Setup → Installed Packages.

Audit trail

Cotillion keeps an immutable record of every payload submitted to a vendor. The record captures exactly what was sent at submission time, independent of subsequent edits in Salesforce or Cotillion.

Reference

Salesforce's official help if your Setup differs from the steps above:

Troubleshooting

The install stops with "ExternalClientApplication(Cotillion) duplicate value found"

Your org already has an External Client App named Cotillion, made by hand. Open it from Setup → External Client App Manager, delete it from the menu on the app's own page (the list offers no Delete), and run the install again.

Authentication fails on Test & Connect

Check the My Domain URL first: it is your org's own address from Setup → Company Settings → My Domain, not login.salesforce.com. If it is right, the Cotillion package is not installed, Enable Client Credentials Flow is off in the Cotillion app's policies, or Run As names no user (Step 4).

Test & Connect fails although the sign-in settings are right, or nothing syncs

The integration user reads only what Cotillion Read Only grants. Check that the set is assigned to the user (Step 3). The package's own set, Cotillion Exclude From Sync, opens only its checkbox and is not for the integration user.

Some opportunities or accounts are missing

Check View All Records on Opportunities, Accounts and Contacts in Cotillion Read Only, then wait for the next sync.

Deals have no notes from tasks

Access Activities is missing from the permission set, or the Task fields from Step 2 are not readable.

The sync paused with an API limit message

Your org's daily API allowance is spent, by Cotillion and your other integrations together. The sync resumes on its own once Salesforce frees requests.

An opportunity is missing from Cotillion

Check its Cotillion Exclude From Sync checkbox (Step 7). Un-tick it to bring it back within about 5 minutes.


For Cotillion-side issues, email support@indyrct.com.

On this page