Skip to main content
You need an administrator profile in your Salesforce org to create an External Client App and pre-authorize users for it.

Create a key pair

The key pair is a certificate you upload to the app and the matching private key. Create both with OpenSSL:

  • cert.crt is the certificate you upload to Salesforce.
  • Copy the full contents of private.key across as the Private Key (PEM), including the BEGIN and END lines.

Create an External Client App

The app holds the certificate and decides which users can connect with it.

1

Start the app

Sign in to Salesforce for the environment you are connecting, then click the gear icon and select Setup.

The Setup sidebar filtered to External Client Apps with External Client App Manager highlighted
2

Fill in the basic information

Complete the Basic Information section.

  • External Client App Name: StackOne Integration
  • API Name: filled in from the app name
  • Contact Email: Your email address
  • Distribution State: Local
The Basic Information section with the app name, API name, contact email and distribution state fields highlighted
3

Add the API scope

Enables actions: Create Business Hours, Create Case, Create Case Comment, Create Email Message, Create Entitlement, Create Knowledge Article, Create Pricebook, Create Record Type, Create Service Contract, Create Social Post, Create Work Order, Delete Case, Delete Case Comment, Delete Entitlement, Delete Knowledge Article, Delete Service Contract, Delete Work Order, Get Case, Get Case Comment, Get Entitlement, Get Knowledge Article, Get Service Contract, Get Work Order, List Activities, List Available Record Types, List Business Hours, List Case Comments, List Cases, List Contacts, List Email Messages, List Email Templates, List Entitlements, List Knowledge Articles, List Outbound Social Accounts, List Pricebooks, List Record Types, List SLA Processes, List Service Contracts, List Social Personas, List Social Posts, List Users, List Work Orders, Publish Knowledge Article, Search Cases, Search Knowledge Articles, Search Work Orders, Update Case, Update Case Comment, Update Entitlement, Update Knowledge Article, Update Service Contract, Update Work Order

Expand API (Enable OAuth Settings) and select Enable OAuth.

  • Callback URL: https://login.salesforce.com/services/oauth2/callback. The form requires a value, but the JWT bearer flow never redirects to it.
  • Under Available OAuth Scopes, select each scope listed and click the arrow to move it to Selected OAuth Scopes.
The API (Enable OAuth Settings) section with Enable OAuth, the Callback URL field and the selected api scope highlighted
4

Upload the certificate

Under Flow Enablement, select Enable JWT Bearer Flow.

  • Under Certificate Upload, click Upload Files and select cert.crt.
  • Click Create.
The Flow Enablement section with Enable JWT Bearer Flow selected, cert.crt attached under Certificate Upload, and the Create button highlighted
5

Select the user's profile

On the new app, open the Policies tab and click Edit. Under App Policies, give the connecting user access to the app.

  • Under Select Profiles, move the user’s profile from Available Profiles to Selected Profiles, or add one of the user’s permission sets under Select Permission Sets.
The Select Profiles section with System Administrator under Selected Profiles highlighted
6

Set the permitted users

Expand OAuth Policies.

  • Permitted Users: Admin approved users are pre-authorized
  • Click Save.
The OAuth Policies section with Permitted Users set to Admin approved users are pre-authorized and the Save button highlighted
7

Copy the consumer key and secret

Open the Settings tab, expand OAuth Settings, and click Consumer Key and Secret.

  • Enter the verification code Salesforce emails you.
  • Copy the Consumer Key across.
  • Copy the Consumer Secret across.
The OAuth Settings section with the Consumer Key and Secret button highlighted

Find your username

The username is the Salesforce user the connection acts as. Every action runs with this user’s permissions, and the user’s profile or permission set must be the one you pre-authorized on the app.

  • Copy the Username across.
  • Format: an email-style login such as integration.user@acme.com
1

Connect

  • Click Connect.
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup.
2

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.