Getting Started

We're glad that you're trying out Cloud Elements and hope you use this section to get familiar with the application. In this section, we'll give you some basic information to acquaint you with Cloud Elements, and then show you how to integrate the Salesforce and Shopify elements so you can sync your contacts between the two.

Documentation and Resources

If you have found your way to this page, you're at least familiar with our documentation. We have many resources available to help you create integrations. Here in the Developer Portal, you can find API reference documentation, guides that provide detailed instructions, a link to Cloud Elements University, and documentation about each of our elements — A prebuilt API integration that enables a connection into a specific cloud application or cloud service endpoint (such as Box or Salesforce.com). We organize our Elements into categories called ‘Hubs’, which allow you to integrate an entire category through a single, uniform API.

Use Search the docs at the top of the page to find information anywhere in the Developer Portal. As you type, matching topics appear with your search term in context. Just click one to jump right to the topic.

As you use the Developer Portal, and especially as you work through the Getting Started guide, we encourage you to provide feedback via the Docs Feedback button, or just email us at documentation@cloud-elements.com.

Definitions

API Hub

An API Hub (Hub) provides uniform APIs to access a collection of resources enabling one-to-many API access to multiple API providers. For example, the CRM hub provides normalized access to multiple CRM application services including Salesforce, Microsoft Dynamics, Netsuite CRM, Sugar CRM, Zoho CRM, and Autotask (we call a connection to each service an Element). Your application can write to the “One” uniform API and get access to “Many” application services in that category. Within the CRM Hub, Cloud Elements has normalized the API calls to multiple resources such as Accounts, Contacts, Leads, Opportunities and more. Hubs represent the intersection of resources across the Elements within that category of application services.

We normalize our API calls for all endpoints, to enable calls between services e.g., Salesforce to HubSpot. However, with this feature, certain endpoint resources cannot be mapped for each hub.

• Hubs provide uniform APIs to access any collection of elements or a set of resources.
• Hubs enable “One-to-Many” access to an entire category of services.
• Hubs are accessed using a consistent RESTful API with a JSON payload regardless of the technology used at the endpoint.
• Hubs rapidly translate calls into the semantic and data structure required by each endpoint.
• Hubs provide a uniform set of interactive API documentation that developers use to access the resources in the Hub.
• Hubs combine resources from multiple categories providing a consistent set of APIs and documentation to access any collection of resources (e.g., combine Salesforce, Box, and QuickBooks API resources into a Hub).

Authenticated Element Instance

An Authenticated Element Instance is single authenticated connection of an element between Cloud Elements and an account at an API provider such as a Salesforce, Marketo, or Netsuite. An authenticated element instance can access all the objects, fields, and data for that account — including custom data. An authenticated element instance is created when a user successfully connects to the endpoint by providing an instance name, the required authentication credentials for that Element, and optional event configuration.

Bulk API

Bulk APIs are the Cloud Elements APIs used to move large amounts of data. Cloud Elements provides the ability to upload and download data in bulk from an endpoint in a normalized way. Cloud Elements will leverage the provider bulk endpoints whenever that is available. But, when the API provider has no bulk endpoints, we provide a pseudo bulk service for uploading and downloading data from the endpoint. For uploads, we accept a file, and then create objects at the endpoint on a record-by-record basis. For downloads, we execute a search API against the endpoint, and loop through all results until we have retrieved all the data. Cloud Elements stores the files (encrypted) on Cloud Elements servers for a maximum of seven days.

CEQL

CEQL is the Cloud Elements Query Language. The search and filter language used by Cloud Elements to standardize searching across all our different elements. Many APIs support some form of searching in their APIs but they’re almost all different, so we have standardized a common way to search across all our elements. Cloud Elements translates the CEQL to the endpoint’s searching syntax, however at times, CEQL supports more than the endpoint.

Common Resource

A Common Resource is a stand-alone resource, created and defined by a user with the intention of creating a one-to-many transformation. Common resources define normalized fields that you can use in place of specific elements to facilitate one-to-many integrations. You map fields from element resources to the common resource fields to create transformations.

Discovery Service

Cloud Elements includes a comprehensive data discovery service that provides normalized metadata, such as the list of field names and types. Additional information, if available from an endpoint, may also be obtained such as: display name, read-only, etc. If an endpoint doesn’t provide discovery service APIs, Cloud Elements will still provide a minimum set of metadata about the given resource (e.g., name and type). Cloud Elements also allows you to discover custom fields (as long as the values are not empty), by supplying an object Id when a native discovery service is not available. The Discovery Service is used along with the Transformation Service to normalize the responses across endpoints.

Element

An Element is a pre-built API integration that enables a connection into a specific API Provider endpoint (e.g., Salesforce, Quickbooks, or Marketo). All Elements start with a normalized set of features, including authentication, resources, paging, errors, events and search. At the hub level, we also seek to support the richer set of APIs that an application provides, even when not all the Elements in that category share that resource. For example, Salesforce Sales Cloud has APIs that many other CRM services do not support. You can find these APIs that are specific to just Salesforce in the documentation for that Element

• Elements share common services including discovery, search query, pagination, bulk uploading and downloading, logging, and interactive documentation.
• Methods are normalized and accessible through RESTful APIs.
• Complete data payloads are returned in JSON and available to transform and normalize to a common resource.
• Cloud Elements keeps each element up-to-date with changes at the endpoint.
• Each elements is a multi-tenant connector supporting an unlimited number of authenticated accounts with no additional code required.

Endpoint

A unique URI that represents a resource and includes the HTTP method and resource. it includes the method (GET, PUT, PATCH), the base URL, and the resource.

Event

An action that occurs at an API provider associated with an authenticated element instance and is monitored either through Polling or Webhooks.

Formula Instance

A specific instance of a formula template configured with explicit variables and associated with specific element instances.

Formula Template

A Formula Template is a reusable workflow that is independent of the element and includes the triggers, steps, and variables for a formula instance to execute the workflow. The steps in a formula template accomplish a wide variety of use cases across different services, such as keeping systems in sync, migrating data between systems, and automating business workflows.

OAuth Proxy

The OAuth Proxy feature gives you the capability to have multiple environments, such as development, QA, etc, with one endpoint application. For example some vendors only allow one callback URL per application. The proxy will allow for the same callback URL to be used with multiple application endpoints. You would then use the proxy address as the Callback URL instead of your own Callback URL. This permits multiple endpoint applications to one callback URL.

Payload

The data returned from an API response. Or, the body of an API request.

Resource

An object or entity that can be accessed via a URI request.

Transformation

A Transformation is the result of mapping an API provider resource to a common resource. This allows you to define the fields to include in a specific resource, map those fields to the fields cotaining the same data in the provider resource, and then transform the data to match the common resource.

• Overview
  • Documentation
  • Definitions
• Manage Your Profile
• Cloud Elements Tour
• Build Your First Integration *