Connect with client credentials
1
Prepare a Connected App in Salesforce
In your Connected App, turn on Enable Client Credentials Flow and set a Run As user. Copy the app’s Consumer Key and Consumer Secret.
2
Add the connection in Noxus
Open Connections → Add connection → Salesforce, then Client Credentials. Enter:
- Instance URL: your org’s address, for example
https://yourcompany.my.salesforce.com. It must start withhttps://. - Consumer Key
- Consumer Secret
Connect with an access token
Open Connections → Add connection → Salesforce, then Access Token. Enter the Instance URL (it must start withhttps://) and the Access Token, then click Connect. Noxus checks the token against your org when you save. A token that Salesforce refuses marks the connection Invalid with “Invalid or expired access token”.
Noxus uses the token as you entered it and does not renew it. When it expires, enter a new one in the connection, or switch to client credentials.
Nodes
In the flow editor, the Salesforce nodes are under Integrations → Salesforce. Each node has a Connection field to pick which Salesforce connection it uses. Every text field can hold a fixed value or a variable from earlier in the flow. Agents can also use these nodes as tools.
Fields under advanced settings are marked (advanced) below. Outputs that hold records are JSON text.
Query Records
Runs a SOQL query on any object, standard or custom.
Outputs: records (the matching records as JSON) and count (how many were found).
Create Salesforce Record
Creates a record of any object.
Outputs: record_id (the new record’s ID) and success (
true).
Update Salesforce Record
Changes fields on one record of any object.
Output: success (
true).
Create Salesforce Contact
Outputs: contact_id (the new contact’s ID) and success (
true).
Get Contact
Output: contact_data (the contact record as JSON).
Find Contact
Fill in at least one search field. A contact matches if it matches any of them: the same email, the same phone, or a name that contains the text.
Outputs: contacts (the matches as JSON, each with its ID, first and last name, email, phone, title, department and account ID) and count.
Find Account
Fill in at least one search field. An account matches if it matches any of them: a name that contains the text, or the same account number, phone or website.
Outputs: accounts (the matches as JSON, each with its ID, name, account number, phone, website, industry, type, billing city and billing country) and count.
Create Salesforce Case
Outputs: case_id (the new case’s ID) and success (
true).
Get Salesforce Case
Output: case_data (the case record as JSON).
Update Salesforce Case
Only the fields you set are changed. Set Status to Closed to close the case.
Output: success (
true).
Triggers
A flow can start when a Salesforce contact is created or updated. In the flow editor, open Triggers and search for “Salesforce”.
Salesforce sends the events to Noxus: the trigger shows a Webhook URL, and you point a Salesforce Platform Event or Change Data Capture notification at it. The trigger’s fields:
The flow receives the contact’s ID, first name, last name, email, phone, title, department, account ID, created date and last modified date. Contact Created starts the flow once per contact ID, even if Salesforce sends the same contact again (it remembers the last 1,000 contacts).