Log in with username and password

Your client application will be authorized to access Responsys's REST APIs.

The very first REST API request must be to authenticate to a specific Responsys account using a username and a password or certificates. Upon successful authentication, a token and an endpoint are returned in the response. You must use these authToken and endPoint values for any subsequent REST API request.

Important Note: For security reasons you must pass username and password as parameters in the POST request body only with the correct content type ('Content-Type': 'application/x-www-form-urlencoded'). Therefore, you must NOT use the URL string for passing in the authentication credentials.

• Service URL: /rest/api/v1.3/auth/token
• Request Method: POST
• Request Header: Content-Type: application/x-www-form-urlencoded
• Request Body: Send the following in the message body, x-www-form-urlencoded:

  
  		user_name=<USER_NAME>
  		password=<PASSWORD>
  		auth_type=password
  		

• Sample Request Body: user_name=<USER_NAME>&password=<PASSWORD>&auth_type=password
• Response:

  
  	{
  	 "authToken" : <AUTH_TOKEN>,
  	 "issuedAt" :  <TIMESTAMP> ,
  	 "endPoint" : <ENDPOINT_URI>
  	}