POST /login

Request

Resource URL

POST https://api.ft.com/login

For security reasons requests must be made over HTTPS,

Parameters

Not supported. Do not supply any query parameters.

Request Headers

HeaderValue
Content-Type
application/json
X-Api-Key <API key value>

Request Body

User credentials required to log in, example payload below:

{
  “email”: “joe.bloggs@ft.com”,
  “password”: “somepassword”,
  “rememberMe”:  true
}

rememberMe field is optional. If true value provided, the session values returned are valid for 6 months instead of the default 24 hours.

Response

HTTP Status Codes

Http StatusDescription
200 OK Login successful
400 Bad request The request was invalid. You may refer to response for details around why the request was invalid
403 Forbidden Invalid API key

200 Created - Login successful

If successful, this method returns a 200 with the newly created session information, representing as per the example below:.

{
  “sessionToken”: “zwhe7_PFm0Yu05NTPPTeXB9EzwAAAVbbrnOqww.MEYCIQCazDcQkQbU6oga1ipnZPiqXfFYWgdB-CK8ghCK92fKsgIhANhec9_Y3Q8U38rwcQ7qGh_Rl6ExiPtuR-YLvyDVCf5Q”,
  “secureSessionToken”: “zwhe7_PFm0Yu05NTPPTeXB9EzwAAAVbbrnOpww.MEUCICEHj0hCdoLQ3CzBqMB_gTAOVNTDWF8odRly8YU4_jDGAiEA8SQrqDHJfgpSs3p7OZ7oTMjUjoWfvsr9NSn4k44AE7Y”
}

400 Bad request - The request was invalid 

An error response with the following format.

{
  “errors”: [
    {
      “code”: “incorrect-credentials”,
      “message”: “Email address and/or password is incorrect.”
    }
  ]
}

403 Forbidden - Your access to the API endpoint was denied

Make sure you are using a valid API key. If you are sure your are using a valid API key, email FT Membership Platform Team for assistance.