emfluence Marketing Platform API Documentation

Changes to Application-Only Access Tokens

Starting 7/10/2022, the endpoint used to retrieve Application-Only access tokens (https://emailer.emfluence.com/login/oauth/applicationAccessToken) will no longer be available.

Retrieving Application-Only access tokens has been deprecated. If your application currently uses the https://emailer.emfluence.com/login/oauth/applicationAccessToken endpoint to retrieve Application-Only access tokens, the only necessary change is to stop making those requests. Your existing Application-Only access token will continue to work.

Please contact support for assistance.

Changes to How Access Tokens Are Passed With Requests

Starting 7/10/2022, all requests must pass the access token in the Authorization header.

Passing access tokens in the request body or querystring has been deprecated. If your application currently authenticates using one of these methods, it will need to be changed to pass the access token in the Authorization header.

Please contact support for assistance.

Valid: Pass Access Token in the Authorization Header

GET

/helper/ping

cURL

Copy

curl https://api.emailer.emfluence.com/v1/helper/ping \
	-H "Authorization: Bearer {{accessToken}}"

Response Data

{"success":1,"data":{"message":"pong"},"code":0,"requestID":"B78DBCA4-F79E-4CA6-A58077CEB5D7D1CB"}

Invalid: Pass Access Token in the Querystring Deprecated

GET

/helper/ping?accessToken=3BC90A14-6647-479D-AEAF-52F05ED5EAFE

cURL

Copy

curl https://api.emailer.emfluence.com/v1/helper/ping?accessToken=3BC90A14-6647-479D-AEAF-52F05ED5EAFE

Response Data

{"data":{},"errors":["Invalid access token"],"warnings":["Passing the accessToken in the querystring or request body is deprecated. Please pass the accessToken in the Authorization header going forward."],"success":0,"code":200,"requestID":"7E9442FF-057E-4212-B88C92B50874249F"}

Invalid: Pass Access Token in the Request Body Deprecated

POST

/helper/ping

cURL

Copy

curl https://api.emailer.emfluence.com/v1/helper/ping \
	-H "Content-Type: application/json" \
	-X POST \
	-d '{"accessToken":"3BC90A14-6647-479D-AEAF-52F05ED5EAFE"}'

Response Data

{"data":{},"errors":["Invalid access token"],"warnings":["Passing the accessToken in the querystring or request body is deprecated. Please pass the accessToken in the Authorization header going forward."],"success":0,"code":200,"requestID":"8C0276AE-4560-4A95-8537B1B4A665D649"}

Important Changes to Authentication

Changes to Application-Only Access Tokens

Changes to How Access Tokens Are Passed With Requests

Valid: Pass Access Token in the Authorization Header

Invalid: Pass Access Token in the Querystring Deprecated

Invalid: Pass Access Token in the Request Body Deprecated