> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Salesforce connector

- Connector: `appmixer.salesforce`
- Version: 1.7.7
- Components: 26 (9 triggers, 17 actions)

Salesforce is much more than just a CRM solution. It brings together all your customer information in a single, integrated platform that enables you to build a customer-centred business from marketing right through to sales, customer service and business analysis. This gives you more complete understanding of your customers to drive your business’s success.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7>
- Documentation: <https://docs.appmixer.com/connector-configuration/salesforce>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/salesforce>
- Download package: <https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/download>

## Authentication

**Type:** OAuth 2

This connector is globally authenticated and verified by Appmixer (Authentication Hub) and is ready to use without registering your own OAuth application with the provider. You can still use your own OAuth credentials (clientId and clientSecret) - see the Connector Configuration section of the documentation. The Authentication Hub is enabled for all hosted Appmixer tenants; on self-managed installations it has to be explicitly set.

## Triggers (9)

- [Account Status Change](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.AccountStatusChange.md) (`appmixer.salesforce.crm.AccountStatusChange`): Triggers with the account details when a chosen status field changes on an Account.
- [Contact Status Change](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.ContactStatusChange.md) (`appmixer.salesforce.crm.ContactStatusChange`): Triggers with the contact details when a chosen status field changes on a specific Contact or on any Contact.
- [Lead Status Change](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.LeadStatusChange.md) (`appmixer.salesforce.crm.LeadStatusChange`): Triggers with the lead details when the Status (or another chosen field) changes on a Lead.
- [New Contact](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.NewContact.md) (`appmixer.salesforce.crm.NewContact`): This trigger fires every time a new contact is added.
- [New Event](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.NewEvent.md) (`appmixer.salesforce.crm.NewEvent`): This trigger fires every time a new event is added.
- [New Lead](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.NewLead.md) (`appmixer.salesforce.crm.NewLead`): This trigger fires every time a new lead is added.
- [New Opportunity](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.NewOpportunity.md) (`appmixer.salesforce.crm.NewOpportunity`): This trigger fires every time a new opportunity is added.
- [Record Field Change](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.RecordFieldChange.md) (`appmixer.salesforce.crm.RecordFieldChange`): Triggers across the platform when a chosen field changes on any record of the selected object (standard or custom).
- [Updated Opportunity](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.UpdatedOpportunity.md) (`appmixer.salesforce.crm.UpdatedOpportunity`): Trigger when Opportunity reaches specific stage.

## Actions (17)

- [Make Api Call](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.core.MakeApiCall.md) (`appmixer.salesforce.core.MakeApiCall`): Performs an arbitrary authorized API call to the Salesforce API.
- [Create Account](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.CreateAccount.md) (`appmixer.salesforce.crm.CreateAccount`): Create a new account in Salesforce.
- [Create Contact](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.CreateContact.md) (`appmixer.salesforce.crm.CreateContact`): Create a new contact in Salesforce.
- [Create Object Record](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.CreateObjectRecord.md) (`appmixer.salesforce.crm.CreateObjectRecord`): Create new Object record.
- [Delete Account](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.DeleteAccount.md) (`appmixer.salesforce.crm.DeleteAccount`): Delete an account in Salesforce.
- [Delete Object Record](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.DeleteObjectRecord.md) (`appmixer.salesforce.crm.DeleteObjectRecord`): Delete Object record.
- [Find Contacts](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.FindContacts.md) (`appmixer.salesforce.crm.FindContacts`): Get all contacts, optionally scoped to a single account and/or campaign, together with their related contact information (name, email, phone, ...).
- [Find Contacts By Field](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.FindContactsByField.md) (`appmixer.salesforce.crm.FindContactsByField`): Get all contacts related to a chosen Contact field value, for example every contact matching a specific Campaign ID, Account or custom field.
- [Get Object Fields](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.GetObjectFields.md) (`appmixer.salesforce.crm.GetObjectFields`): Get Object fields.
- [Get Object Record](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.GetObjectRecord.md) (`appmixer.salesforce.crm.GetObjectRecord`): Get Object record.
- [Get Profile Info](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.GetProfileInfo.md) (`appmixer.salesforce.crm.GetProfileInfo`): Gets the current user's profile information.
- [List Campaigns](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.ListCampaigns.md) (`appmixer.salesforce.crm.ListCampaigns`): List all campaigns in Salesforce.
- [Query](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.Query.md) (`appmixer.salesforce.crm.Query`): Executes the specified SOQL query. See more in the [SOQL Docs](https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_soql_select.htm).
- [Update Contact](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.UpdateContact.md) (`appmixer.salesforce.crm.UpdateContact`): Update a contact in Salesforce.
- [Create Lead](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.CreateLead.md) (`appmixer.salesforce.crm.CreateLead`): Create a new lead in Salesforce.
- [Update Lead](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.UpdateLead.md) (`appmixer.salesforce.crm.UpdateLead`): Update a lead in Salesforce.
- [Update Object Record](https://connectors.appmixer.com/connector/appmixer.salesforce/1.7.7/component/appmixer.salesforce.crm.UpdateObjectRecord.md) (`appmixer.salesforce.crm.UpdateObjectRecord`): Update Object record.

## Changelog

### 1.7.7

- Declared lodash as a direct dependency. It was previously only installed as a transitive dependency. No functional change.

### 1.7.6

- Quote CSV cells that hold a comma, a double quote or a line break and map cells by header column when exporting results to a file.

### 1.7.5

- MakeApiCall: Request Headers and Query Parameters set in the Designer are now sent. They were silently dropped: the key-value field stores its rows as a JSON object string, which the component did not parse.

### 1.7.4

- OAuth: the authorization flow now uses PKCE (S256). Salesforce requires PKCE for External Client Apps and is enforcing it for Connected Apps; without it, Connect account failed with "missing required code challenge".
- OAuth: a rotated refresh token returned by the token refresh is stored, so apps with Refresh Token Rotation enabled keep working after the first refresh.

### 1.7.3

- Output example for the Query emptyResult records.

### 1.7.2

- Added output examples to CreateObjectRecord, GetProfileInfo and the NewContact, NewEvent and NewLead triggers. NewLead's Address and AnnualRevenue are now declared as an object and a number (Salesforce returns a compound address and a currency value), and fields that are empty on a new lead are declared nullable.

### 1.7.1

- Fixed a crash when a Find/List component saved an EMPTY result set to a CSV file — the header row was built from the first record without checking there was one, so a search that legitimately matched nothing failed the flow instead of writing an empty file.

### 1.7.0

- New Actions: Find Contacts - returns contacts, optionally filtered by Account and/or Campaign membership; Find Contacts by Field - returns contacts matching a chosen field value with Exact/Contains/Starts-with match types. Both emit to a notFound port when nothing matches.
- New Actions: Create Account, Delete Account and List Campaigns.
- Create Contact: Account is now optional; Account and Reports To inputs accept variables and manual input.
- Update Contact: Contact, Account and Reports To inputs accept variables and manual input; can be used to assign or move a contact to an account.
- Status-change triggers and Record Field Change: object/field dropdowns accept manual input and describe calls are cached.
- Dropdown source calls are cached to conserve the Salesforce API request quota.

### 1.6.0

- New Trigger: Lead Status Change - triggers with the lead details when the Status (or another chosen field) changes on a Lead.
- New Trigger: Contact Status Change - triggers when a chosen status field changes on a specific Contact or on any Contact.
- New Trigger: Account Status Change - triggers with the account details when a chosen status field changes on an Account.
- New Trigger: Record Field Change - triggers when a chosen field changes on any record of a selected object (standard or custom).

### 1.5.0

- Added MakeApiCall component for performing arbitrary authorized API calls to the Salesforce API.

### 1.4.0

- Added test() (Flow Test Mode) to all triggers: NewContact, NewEvent, NewLead, NewOpportunity, UpdatedOpportunity.

### 1.3.4

- Added output examples to component schemas.

### 1.3.3

- New Lead, Create Lead, Update Lead - enhance the output schema.

### 1.3.2

- New Trigger: Updated Opportunity - triggers when an Opportunity changes to a specified stage.
- New Action: Get Profile Info - Gets the current user's profile information.

### 1.2.2

- Fields generated for CreateObjectRecord and UpdateObjectRecord are now cached for 5 minutes before refreshed.

### 1.2.1

- Support for custom objects. Added generic components: ListObjects, GetObjectFields, CreateObjectRecord, GetObjectRecord, UpdateObjectRecord, DeleteObjectRecord and Query. 'Record' is either standard SalesForce object or Custom object.

### 1.1.3

- Added customFields in CreateContact and updateContact.

### 1.1.2

- Reordered inputs of CreateContact.

### 1.1.1

- Apply configurable baseUrl to all auth methods.

### 1.1.0

- Configurable OAuth baseUrl.

### 1.0.0

- Initial version.
