Legacy authentication method: JSESSIONID user sessions

❗️

Feature is deprecated

If your organization was created after April 30, 2019, OAuth will be the only option of authentication that is available to you. For any questions about migrating onto the OAuth process, contact your CSM or Support.

Our Username/Password paradigm for authenticating against both our UI and our API will continue to be supported, but is considered to be a legacy feature. This approach allows your external systems to securely store a customer-defined integration user’s credentials within them to subsequently authenticate and gain access to the Campaign Automation.

Note: After completing the API actions, you must use a Logout request to close and invalidate the session. The methods used for authenticating against Engage with JSESSIONIDs are as follows.

User Login

Login
Before calling any operation, you must obtain a Jsession ID using the Login operation as shown below.

Operation
Elements

  • USERNAME - Campaign Automation user’s name
  • PASSWORD - Campaign Automation user’s password
    Example
    userpassword

Response
Elements

  • SUCCESS - TRUE (Always set to TRUE for successful login)
  • SESSIONID - System-generated session ID
  • SESSION_ENCODING - Encoding of the system-generated session ID. The format for SESSION_ENCODING is as follows: ;jsessionid=SESSIONID where SESSIONID is the system-generated session ID returned.
  • ORGANIZATION_ID - Identifies your Campaign Automation Organization
    Example
    true dc302149861088513512481 ;jsessionid=dc302149861088513512481

User Logout

Logout
After completing the API actions, you must use a Logout request to close and invalidate the session, as shown below.

This API call is important both from the perspective of better securing your customer data from hackers as well as allows our servers to perform optimally for your subsequent calls.

Operation
Elements - None
Example

Response
Elements

  • SUCCESS - TRUE (To successfully log off the system, always set to TRUE)
    Example
    TRUE