/// <summary>
        /// Used to authorize the <see cref="PivotalTracker"/> instance with username/password credentials.
        /// </summary>
        /// <param name="username">Your Pivotal Tracker username.</param>
        /// <param name="password">Your Pivotal Tracker password.</param>
        public async Task <PivotalUser> AuthorizeAsync(string username, string password)
        {
            if (string.IsNullOrWhiteSpace(username) || string.IsNullOrWhiteSpace(password))
            {
                throw new PivotalMethodNotValidException("Please make sure you are passing a username and password.");
            }
            var authorisationResponse = await HttpService.AuthorizeAsync(username, password);

            var authUser = HandleResponse <PivotalUser>(authorisationResponse);

            if (authUser != null)
            {
                _apiToken = authUser.ApiToken;
                HttpService.SetupHttpClient(_apiToken);
            }

            return(authUser);
        }