Skip to main content




Service Studio version:

Salesforce integration

  • Edit
    Collaborate with us
    Edit this page on GitHub
  • Prerequisites

    • Make sure you meet the general Integration Builder prerequisites.
    • Your OutSystems development environment can make HTTPS outbound requests to your Salesforce instance, available at *
    • You have a Salesforce user with an Administrator role.

    Authorizing Integration Builder in Salesforce

    Follow the instructions provided in Creating and using an integration. You must authorize Integration Builder to access your data (list of objects) through your Salesforce account.

    Authorizing Integration Builder in Salesforce

    Integration Builder uses this authorization to obtain the available objects for building a Salesforce integration.

    Additionally, when you're creating a connection, Integration Manager connects to Integration Builder, requesting the creation of a Salesforce connected app. This operation uses the same authorization, since only Integration Builder has the access tokens for this authorization.

    Authorizing a Salesforce connection

    Salesforce integrations generated with Integration Builder use an access token to authenticate requests.

    Request authentication is handled transparently when you call Server Actions exposed by the service module (the module with a "_IS" suffix, by default). The Server Actions obtain the token from the connection that you previously associated with the integration in Integration Manager. Therefore, you don't need to provide a token as an input parameter.

    You can authorize a Salesforce connection in the following ways.

    If you have administrator permissions in Salesforce

    Integration Builder creates a connected app in Salesforce at the request of Integration Manager. Then, Integration Builder returns the obtained access token for this specific app to Integration Manager. Integration Manager saves this access token in an encrypted way as part of the connection information.

    If you don't have administrator permissions in Salesforce

    Creating a connection without administrator credentials requires parameters from the Salesforce platform. The Salesforce account administrator needs to create a new connection (Connected App) to obtain these parameters.

    Integration Builder can send an email to the administrator requesting the information you need. The email includes a unique authorization certificate, and instructions on how the administrator proceeds.

    Once you receive the information, enter it into Integration Builder, and select Create connection.

    Connection fields

    • Email address of the app administrator — The email address that Salesforce uses to contact you or your support team.

    • Salesforce username — The username of the Salesforce account that you want to associate with all requests that Integration Builder sends to the Salesforce API. Salesforce usernames look like email addresses (for example, but don't have to be an actual email address.
      If you're not sure, search your inbox for the following emails that include your username: "Subject: Welcome to Salesforce: Verify your account", or "Subject: Finish resetting your Salesforce".

    Use the integration in Service Studio

    Check out how to use the integration in Service Studio.

    • Was this article helpful?