> For the complete documentation index, see [llms.txt](https://docs.loginwithlink.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.loginwithlink.com/use-api-only/authenticate.md).

# Authenticate

## Request

POST to the following URL

```
POST https://loginwithlink.com/api/authenticate
```

Include:

* The \`client\_secret\` you received in step 1 (lookup).
* The \`email\` of the consumer.
* The six-digit code they have entered.

## Response

### If six-digit code is correct

We'll return a user object along with `` `authenticationSuccessful: true` `` 

```json
// if user code is correct
{ authenticationSuccessful: true,
  user: {
    email: "m@rkmoriarty.com"
  }
}
```

If you've been pre-approved, and if the user has such information saved, the user object may be enhanced with additional information:

```json
{ authenticationSuccessful: true,
  user: {
    email: "m@rkmoriarty.com",
    fullName: "Mark Moriarty",
    city: "San Francisco, California 94114",
  }
}
```

### If the six-digit code is not correct:

We'll return `` `authenticationSuccessful: false` `` along with an an error message.

```json
{ authenticationSuccessful: false,
  errorMessage: "m@rkmoriarty.com"
}
```