| Applies toAPI | AudienceAll users | Last updatedNovember 12, 2025 |
Note
The following configuration must be done to provide GoldFinch Read/Write access to an external Software Provider.
Create a New User with the Correct Permissions/License
-
Acquire a Salesforce license for a new user.
-
API (or limited) license (lower cost)
-
A Standard Salesforce license is not required (more expensive)
-
-
Create a new User.
-
Name the user as api.[edi software provider name]@[client's domain]
-
Example: api.trinity@beyondbetterfoods.com.uat
-
-
User License must be Standard Platform.
-
Profile must be Standard Platform User.
-
Assign GFERP Extension App and GFERP Standard ERP Users
-
If in a Production Environment, assign a GFERP license.
-
Reset the new user's password.
The configuration must be completed in the UAT instance first, followed by the PROD instance. Use an internal support email as the email address.
Retrieve a Security Token
-
Log in as the API user.
-
Click My Setting > Reset My Security Token.
-
A new security token will be sent to the registered email address.
Create an API App
-
In Setup, click Apps → App Manager and click New Connected App to define a connected app.
-
Enter the name of your application, for example, Infoconn EDI.
-
Enter the contact email address and other relevant details for your application.
Use the Goldfinch support email address as support@goldfinchcloudsolutions.com -
Before the Go-Live, update the email address to the email address of the EDI partner.
-
Integral: goldfinch_api@integralgroup.ca
-
Infoconn: support@infoconn.com
-
-
Make sure Enable OAuth Settings is checked.
-
Enter a Callback URL of http://localhost.
Depending on the OAuth flow you use, the user browser redirects to this URL after successful authentication. This URL must use secure HTTP (HTTPS) or a custom URI scheme, as it is used for OAuth flows to pass an access token.If testing with Postman, enter https://www.getpostman.com/oauth2/callback. The third-party application must provide the callback URL if it uses a callback.
-
Add Full Access, as supported OAuth scopes to Selected OAuth Scopes.
These scopes refer to permissions provided by the user executing the connected app. -
Click Save.
The Consumer Key is created and displayed, and the Consumer Secret is created (click the link to view it). -
Note
down the Consumer Key and Consumer Secret.
You will not be able to retrieve them after closing the page.
Test the Login Credentials
-
Download and install Postman API client API Client for REST, SOAP, & GraphQL Queries | Postman.
-
Change to Post.
-
Copy and paste https://test.salesforce.com/services/oauth2/token
-
(do not use client's actual URL, such as https://belgianboys--uat.my.salesforce.com/ )
-
-
For live instance, use https://login.salesforce.com/services/oauth2/token
-
(do not use the client's actual URL Login | Salesforce )
-
-
In the Authorization tab, select oAuth 2.0. Do not change other parameters.
-
In the Body tab, select form-data.
-
Provide the parameters in Key and Value. The value in Key must be in lowercase.
-
Password must be the password followed by the security token (do not provide any spaces in between).
-
Click Send.
-
If successful, you will receive an access token.
OAuth and OpenID Connect Settings
OAuth and OpenID Connect Settings Should be enabled
Credentials to share with the External Partner
Provide the following parameters to the EDI partner in addition to the success message screenshot using Postman, for the UAT and PROD environments.
-
Consumer Key
-
Consumer Secret
-
Username
-
Password
-
Security Token
Additional Support Documentation
Salesforce supports both SOAP and REST.
Salesforce API governor limits - Salesforce Developers
Salesforce API documentation links - https://trailhead.salesforce.com/en/content/learn/modules/api_basics/api_basics_rest
Article API-User-Setup---Used-by-Internal-Team · Last updated November 12, 2025 · GoldFinch ERP Help Center
Comments
0 comments
Please sign in to leave a comment.