How to set up (on Geotab)

These are the workflows required to implement the solution.

1. In MyGeotab, navigate to People ⇒ Users & Drivers ⇒ Add
   1. Follow the guidelines in the Service Account documentation

How to set up (on Salesforce)

1. Ensure that your Account sObject has the appropriate custom fields necessary, create if necessary 
2. Configure the authorization flow, follow here
3. Configure Salesforce CORS Allowlist for your application, follow here
4. Perform a test call using cURL or the Salesforce Postman library

How to set up Middleware

1. Configure the Middleware to authenticate into MyGeotab using the service account for the appropriate database.
2. OPTIONAL: 
   It is possible to stream data from a MyGeotab database to a relational database in your environment. Integrations might choose to do this to cache data, or to repurpose data for other needs. Using this method, the Middleware would call the relevant data from the environment instead of making a Geotab API call. See the MyGeotab API Adapter documentation for more details.
3. Make a GetFeed call to get the net new User entities.
   You can test the JavaScript example in Geotab's SDK Runner. The example returns the first 10 results from the first Users added to the database. In reality, you would store the last returned version  from the previous GetFeed and check for any new User objects since then.
   
    

let feed = (() => {

                let version = "0000000000000000";

                     return {

                     next: success => {

                         api.call("GetFeed", {

                             "typeName": "User",

                             "resultsLimit": 10,

                             "fromVersion": version,

                         }, result => {

                             version = result.toVersion;

                             success(result.data);

                         });

                     }

                 };

             })();

             feed.next(data => {

                 console.log("First part: ", data);

                 setTimeout(() => {

                     feed.next(data => {

                         console.log("Second part: ", data);

                     });

                 }, 1000);

             });

4. Authenticate against your Salesforce domain, see example call below

curl https://MyDomainName.my.salesforce.com/services/data/v59.0/composite/ -H "Authorization: Bearer token -H "Content-Type: application/json" -d "@composite.json"

5. Iterate over the list of User entities from the GetFeed call
6. In each iteration, call the following REQUEST with the body example provided below.
   Replace the USER_EMAIL with the Geotab username in the User entity, and any Geotab fields relevant to the custom fields. 

{

    "allOrNone" : true,

    "compositeRequest": [{

        "method": "POST",

        "url": "/services/data/v59.0/sobjects/Account/ExternalAcctId__c/ID12345",

        "referenceId": "NewAccount",

        "body": {

"AccountId" : "@{NewAccount.id}" 

             "Name": "USER_EMAIL",

      "ANY_OTHER_CUSTOM_FIELD_cc": : "CUSTOM_FIELD_VALUE"

        }

    },{

        "method" : "POST",

        "url" : "/services/data/v59.0/sobjects/Contact",

        "referenceId" : "newContact",

        "body" : {

"AccountId" : "@{NewAccount.id}" 

             "Name": "USER_EMAIL",

      "ANY_OTHER_CUSTOM_FIELD_cc": : "CUSTOM_FIELD_VALUE"

        }

    }]

}

7. Validate the RESPONSE body such that the API call was successful.