Salesforce Marketing Cloud (Fuel) Authentication
Authenticates and retrieves an access token for the Salesforce Marketing Cloud API. The token can be used for either the REST or SOAP API.
Features
- Simple
- Lightweight
- Modern: utilizes ES6, Promises via
async/await
, Object rest spread, andnode-fetch
- As such, Node 8.6 or higher is required.
Install
Install with Yarn
yarn add marketing-cloud-auth
Usage
To retrieve an access token, require the class and provide your API client ID and secret.
// your-file.jsconst MarketingCloudAuth = ; // Instantiate the `MarketingCloudAuth` classconst auth = clientId: 'your-client-id' clientSecret: 'your-client-secret'; // Retrieve an access token using async/await...const retrieve = async { const token = await auth; console; // Will output somthing similar to // { value: 'your-token', expiresIn: 3479 }}; // Or directly with a promise...auth;
Subsequent calls to auth.retrieve
will not make additional HTTP requests unless the token has expired or you explicitally force a new call via auth.retrieve({ force: true })
.
Once the token is retrieved, you can include it in your REST API calls:
GET https://www.exacttargetapis.com/platform/v1/endpointsAccept: application/jsonAuthorization: Bearer YOUR_ACCESS_TOKEN
Or your SOAP calls
YOUR_ACCESS_TOKEN<!-- OR (depending on which Salesforce docs you trust...) --> YOUR_ACCESS_TOKEN [...]
For more information, see