Authentication Prerequisites
The Sugar Enterprise element uses the OAuth2password authentication workflow. Before you can authenticate an instance of the Sugar Enterprise element, you require the following:
Provider sandbox
A Sugar Professional account and sandbox are required to authenticate. Only Administrator accounts can generate the credentials required to authenticate with the element. The only parameters required by the user are:
- Sugar Enterprise Site URL
- Username
- Password
- Navigate to Admin > System Settings.
- Scroll to the Advanced section at the bottom of the page.
- Uncheck "Validate user IP address".
- Click "Save"to preserve the changes.
Required Authentication Parameters
You can authenticate an element instance using the UI or via API calls. For detailed information on how to authenticate an instance, see our related documentation:
To authenticate an instance of the Sugar Enterprise element, you will need the following parameters:
Parameter Name/UI Value | API Value/Key | Description | Source |
---|---|---|---|
Sugar Enterprise site URL | site.url | The unique URL established for your Sugar Enterprise site. | This is the same URL that you use to sign in to your Sugar Enterprise platform. Contact your Sugar admin for assistance. |
Username | username | The username you use to sign in to your Sugar Enterprise site. | Contact your Sugar admin for assistance. |
Password | password | The password you use to sign in to your Sugar Enterprise site. | Contact your Sugar admin for assistance. |
Sample Configuration JSON
"configuration": {
"site.url": "http://my-sugar-enterprise-url.com",
"username": "MyUsername",
"password": "MyPassw0rd"
}
Element Fact Sheet and Reference
Authentication and Configuration Parameters
To see all authentication parameters for the Sugar Enterprise element, follow these steps:
- Sign in to Cloud Elements and navigate to Elements.
- Hover over the card for an element, and then click My Resources.
- In the top navigation toolbar, click Setup.
- From the Setup page, you can view a complete list of the element's authentication and configuration parameters.
Events and Supported Resources
The Sugar Enterprise element supports events via polling. For detailed information about our Events framework and how to configure an element instance with events, see our documentation:
You can set up polling events for the following resources of the Sugar Enterprise element:
- accounts
- campaigns
- contacts
- contracts
- calls
- leads
- meetings
- opportunities
- products
- tasks
- quotes
- documents
- emails
- productGroups
- revenueItems
- cases
- prospectLists
Queryable Endpoints
You can use CEQL to query the following endpoints of the Sugar Enterprise element:
- GET /accounts
- GET /activities
- GET /bulk/jobs
- GET /calls
- GET /campaigns
- GET /cases
- GET /contacts
- GET /contracts
- GET /documents
- GET /emails
- GET /leads
- GET /meetings
- GET /notes
- GET /{objectName}
- GET /{objectName}/{objectId}/{childObjectName}
- GET /opportunities
- GET /product-groups
- GET /products
- GET /prospect-lists
- GET /quotes
- GET /revenue-items
- GET /shippers
- GET /tasks
- GET /tax-rates
Element API Documentation
The base URL for all API requests is https://api.cloud-elements.com/elements/api-v2
.