Connect to SendGrid Data through External Services in Salesforce

CData Connect AI, enables you to access SendGrid data from cloud-based applications like the Salesforce and mobile applications like the Salesforce Mobile App. In this article, you will use CData Connect AI to access SendGrid data through Salesforce External Services.

Connect to SendGrid from Salesforce

Overview

Here is an overview of the steps:

1. Configure: (Optional) Set up your SendGrid data source in CData Connect AI, add a Workspace, add assets to your Workspace, and generate a Personal Access Token (PAT).
2. Connect: Link Salesforce to CData Connect AI using OpenAPI.
3. Explore: Use your connected data in Salesforce.

Prerequisites

Ensure you have the following before starting:

1. An active SendGrid account and credentials.
2. A CData Connect AI account. Log in or sign up for a free trial here.
3. A Salesforce account.

---

Connect to SendGrid from Connect AI

CData Connect AI uses a straightforward, point-and-click interface to connect to data sources.

1. Log into Connect AI, click Sources, and then click Add Connection
👁 Adding a Connection

2. Select "SendGrid" from the Add Connection panel
👁 Selecting a data source

3. Enter the necessary authentication properties to connect to SendGrid.

   To make use of all the available features, provide the User and Password connection properties.

   To connect with limited features, you can set the APIKey connection property instead. See the "Getting Started" chapter of the help documentation for a guide to obtaining the API key.

   👁 Configuring a connection (Salesforce is shown)
   
4. Click Save & Test
5. Navigate to the Permissions tab in the Add SendGrid Connection page and update the User-based permissions. 👁 Updating permissions
   

Add a Personal Access Token

When connecting to Connect AI through the REST API, the OData API, or the Virtual SQL Server, a Personal Access Token (PAT) is used to authenticate the connection to Connect AI. It is best practice to create a separate PAT for each service to maintain granularity of access.

1. Click on the Gear icon () at the top right of the Connect AI app to open the settings page.
2. On the Settings page, go to the Access Tokens section and click Create PAT.
3. Give the PAT a name and click Create. 👁 Creating a new PAT
   
4. The personal access token is only visible at creation, so be sure to copy it and store it securely for future use.

Configure SendGrid Endpoints for Salesforce

After connecting to SendGrid, create a workspace for your desired table(s).

1. Navigate to the Workspaces page and click Add to create a new Workspace (or select an existing workspace). 👁 The Workspaces page.
   👁 Adding a new Workspace.
   
2. Click Add to add new assets to the Workspace.
3. Select the SendGrid connection (e.g. SendGrid1) and click Next. 👁 Selecting an Asset (Salesforce is shown).
   
4. Select the table(s) you wish to work with and click Confirm. 👁 Selecting Tables (Salesforce is shown).
   
5. Make note of the OpenAPI URL for your workspace, e.g. https://cloud.cdata.com/api/openapi/v3/{workspace_name}...

Check the column data types of the selected table:

1. Once the SendGrid data table is added as an asset, select the asset, and note the column names and data types from the Columns tab. 👁 Note the column names and data types
   
2. In the Preview tab, preview the current data in the table to be referenced later. 👁 Preview the current data
   
3. Click on Users from the left panel and search for your username, e.g. [email protected]. Click on the same.
4. On the Edit Users screen, grant the respective user all Permissions (Select, Insert, Update, Delete, and Execute) for the entity (workspace).

With the connection, PAT, and Workspace configured, you are ready to connect to SendGrid data from Salesforce.

Connect to SendGrid Data as an External Service

Create a Named Credential

Follow the steps below to connect to the OpenAPI produced by CData Connect AI with Salesforce:

1. Log into Salesforce and navigate to Setup. 👁 Log into Salesforce and open Setup
   
2. Search for Named Credentials in the search bar and click on it. 👁 Search Named Credentials
   
3. Select New -> New Legacy. 👁 Select New Legacy
   
4. Add the given details in the New Named Credential screen:
   • Label: enter a label of your choice
   • Name: enter a name for the named credential
   • URL: https://cloud.cdata.com
   • Identity Type: Named Principal
   • Authentication Protocol: Password Authentication
   • Username: enter your CData Connect AI username. This is displayed in the top-right corner of the CData Connect AI interface. For example, [email protected]
   • Password: enter the PAT you generated on the Settings page
   • Generate Authorization Header: enable the checkbox

Click Save to save the details.

👁 Save the Named Credential details

Create an External Service

1. Now, search for External Services in the search bar and click on it. 👁 Search for External Services
   
2. In the Add an External Service page, click From API Specification under Select an API Source. 👁 Click "From API Specification"
   
3. In the Enter an Existing Service page, enter the given details under Modify Exiting Registration Details:
   • External Service Name: enter an identifying name for your external service
   • Description: enter a description of your external service (not a mandatory field)
   • Service Schema: Relative URL
   • Select a Named Credential: OpenAPI
   • URL: copy the OpenAPI URL from Connect AI and remove https://www.cdata.com and keep the rest of the URL. Make sure the URL starts with a forward slash "/api...".
   👁 Enter the External Service details
   

   If the connection is successful, the message "Schema validation completed successfully!" will be displayed on the screen. Click Save & Next

4. Select all the entities in the Select Operations screen. Click Next. 👁 Select all the Operations entities
   
5. All the schema-generated actions are displayed in the Review External Services Actions screen. Click Finish. 👁 Review External Services actions
   
6. The External Services page will display all the external services created. 👁 Page displaying all external services
   

Create a new Flow

1. Search for Flows in the search bar and click on it.
2. Click New Flow. 👁 Click New Flow
   
3. Select Start From Scratch option and click Screen Flow. 👁 Start from scratch
   👁 Start screen flow
   
4. In the Flow Builder screen, click on the "" between Screen Flow and End.
5. Select Screen from Add Element. 👁 Add a screen
   
6. In the New Screen window, enter "Input Screen" in Label and the API Name will be auto-filled accordingly. 👁 Enter Input Screen in the Label
   
7. Next, based on the table you want to update, note the column data types to add the components to the flow.
8. Now, for the orderid column, search for the "Number" component in the Components search bar and click on it. Enter Label as "Enter Order ID" and again API Name will be auto-filled accordingly. Enable the Require checkbox and apply this for steps 9 and 10. 👁 Add the Order ID label
   
9. For the ordername column, search for the "Text" component in the Components search bar and click on it. Enter Label as "Enter Order Name". 👁 Add the Order Name label
   
10. For the personid column, search for the "Number" component in the Components search bar and click on it. Enter Label as "Enter Person ID". 👁 Add the Person ID label
    
11. Click Done and Input Screen will be added in the Flow Builder. 👁 Click Done
    
12. Now, add an element Action below the input screen in the flow. 👁 Add the Action element
    
13. Under Search Actions, search and click the newly created external service, in this case, OpenAPI1. 👁 Search the newly created external services
    
14. Click Create Orders. 👁 Create Orders
    
15. Enter a name in Label, the API Name gets auto filled. 👁 Enter a name in the label
    
16. Click on the search bar under Set Input Values for the Selected Action and select New Resource -> Variable. 👁 Select New Resource
    👁 Select Variable
    
17. In the New Resource window, enter the following details:
    • Resource Type: Variable
    • API Name: Body
    • Data Type: Apex-Defined
    • Apex Class: ExternalService_
    • Availability Outside the Flow:
      • Available for input: enable checkbox
      • Available for output: enable checkbox
      👁 Add details for the new resource
      👁 Add the Apex Class
      
18. Add a new element Assignment and add the Label name as "SendBody". Again, the API Name gets auto-filled. 👁 Add a new element "Assignment"
    
19. Set the given values under Set Variable Values:
    • Variable: Body>orderid; Operator: Equals; Value: Input Screen>Enter Order ID
    • Variable: Body>ordername; Operator: Equals; Value: Input Screen>Enter Order Name
    • Variable: Body>personid; Operator: Equals; Value: Input Screen>Enter Person ID
    👁 Click variable "Body"
    👁 Click Order ID
    👁 Select the value as Enter Order ID
    👁 Fill all the three variable values as shown
    
20. Add another Screen element below the Action element. 👁 Add a new screen element
    
21. Name the Label as "Display". 👁 Name the label as "Display"
    
22. Under Components, search for the "Display Text" component and click on it.
23. Set the API Name as "Display_Result" and in the Inside a resource search bar, select Create a new order -> response code. Click Done. 👁 Search "Display Text" and add an API name
    👁 Searh the action "Create a new order" and click "responseCode"
    👁 Click Done
    
24. The flow is now ready. Click Save to save the flow and add a name to the Label as the flow name, in this case, "CreateOrdersPage". Click Save. 👁 Click Save to save the flow
    👁 Add a flow name in the label
    
25. The flow is displayed on the Flow Builder screen. Click on Activate to activate the flow. 👁 The flow is displayed on the flow builder. Click Activate
    👁 The flow is activated
    

Check the flow and verify the updated details in Connect AI

1. Click Debug. The Debug flow window opens. Click Run. 👁 Click Debug
   
2. In the details input page, in this case, "CreateOrdersPage", enter the details (Orders ID, Orders Name, and Person ID) and click Next. 👁 Enter the details to be edited in the SendGrid table
   
3. The next page displays the message "200" (HTTP 200 - OK) and the right pane displays the debug details. Click Next. 👁 The page diplays a HTTP 200 OK message to show the entry success
   
4. You can change the inputs or run the process again to enter new details. 👁 You can change the inputs and run the flow again
   
5. Check in Connect AI if the new details are updated in the "Orders" table, as this article outlines. This completes the process.

Simplified access to SendGrid data from cloud applications

At this point, you have a direct, cloud-to-cloud connection to live SendGrid data from Salesforce. For more details on accessing live data from over 100 SaaS, Big Data, and NoSQL sources through cloud applications, visit our CData Connect AI page.

Reach out to our Support Team if you have any questions.