Skip to main content
Noxus reads and writes Salesforce records: contacts, accounts, cases, and records of any standard or custom object. A Salesforce connection points at one org and offers two ways to sign in:

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 with https://.
  • Consumer Key
  • Consumer Secret
Click Connect. Noxus requests a token from your org and checks it when you save. If Salesforce refuses the key or secret, the connection shows Invalid with Salesforce’s reason.
While a flow runs, Noxus requests a fresh token when the current one is about to expire, so the connection keeps working without changes.

Connect with an access token

Open Connections → Add connection → Salesforce, then Access Token. Enter the Instance URL (it must start with https://) 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).

When a node fails