How does authentication work? (To Cloud Elements and to the Endpoint)

Authentication to any of Cloud Elements’ APIs will use the same format. You will include one Header with a User Secret and an Organization Secret for platform APIs. For a call to an instance you will need to include an Element Token.

For example, for a call to GET /accounts, the Authorization header will look like this:

Authorization: User <user secret>, Organization <organization secret>

A call to an instance GET /hubs/crm/accounts in Salesforce will look like this:

Authorization: User <user secret>, Organization <organization secret>, Element <element token>

Authorization to any endpoint will be handled when you create an Element Instance. If an endpoint is Basic Authentication or SOAP, like NetSuite or Pipedrive, we will save your UserName and Password for future requests. You will receive an Element Token for that instance that you will send in the Authentication header.

For OAuth2 Elements, such as Box and Google Drive, you will go through the OAuth2 flow to log in at the provider. We will keep that connection alive for you forever. After the instance is created, just save the Element Token and we will handle refreshing the Access-Tokens for you.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request