Login

[#1]

Authenticates account users and establishes a secure session.

Resource URL

POST https://api.tealiumiq.com/v1/login

CAUTION: Inserting a slash (/) at the end of this url may cause authentication to fail.

Form Parameters	Description	Example value
username	login name	john@acme.com
password	login password	HG4ljd$^h*

Request Header

Header Field Name	Description	Example value
Content-type	Indicates the MIME type of the body of the GET request	application/x-www-form-urlencoded
jsession cookie	Cookie for sending jsession ID, i.e. the unique session identifier	JSESSIONID=415072043799098022

Example Response

Status 200 OK is returned when the call is executed successfully.

{
   "utk": "65489FDSTJGF549870FSH",
}

IMPORTANT: Make sure to provide this utk token and the jsession cookie with all the other calls of this API.

Error Messages

If the call fails, the API returns a 401 Authentication Failure error. Here are the error messages you can expect to see:

{ 
   "returnCode" : 1401,
   "message" : "Authentication Failed"
}

{ 
   "returnCode" : 1402,
   "message" : "Too many unsuccessful login attempts. Please try again in 10 minutes" 
} 

{ 
   "returnCode" : 1469,
   "message" : "Although the user is authenticated, the request is denied due of lack of proper permissions" 
}