Quick Start
This page takes you from a fresh install to an authenticated REST API call in five steps. Each step links to the full reference if you need more options.
All examples use https://example.com - replace it with your site URL. If your site does not use pretty permalinks, replace /wp-json/ with /?rest_route=/ (see Server).
1. Install the plugin
Install and activate Simple JWT Login from Plugins → Add New in WordPress, or with WP-CLI:
wp plugin install simple-jwt-login --activate
For more options, see the Installation guide.
2. Set the signing key
Go to Settings → Simple JWT Login → General. In the JWT Verification Rules ELSE row:
- Choose an algorithm -
HS256is the simplest choice. - Enter a long, random secret key.
- Click Save Changes.
Anyone who knows the secret key can forge valid tokens. For production, consider storing it in wp-config.php instead of the database - see Key source.
3. Enable authentication
Go to Settings → Simple JWT Login → Authentication, turn on Allow JWT Authentication, and save. While you are there, also turn on Allow Validate Token Endpoint - step 5 uses it.
Every endpoint is disabled by default. A disabled endpoint returns a 403 with an error code such as 45 (authentication) or 82 (validate token). The Endpoints overview lists the setting that enables each one.
4. Get a JWT
Send the user's credentials to the /auth endpoint:
curl -X POST "https://example.com/wp-json/simple-jwt-login/v1/auth" \
-H "Content-Type: application/json" \
-d '{"email":"user@example.com","password":"the-user-password"}'
Response:
{
"success": true,
"data": {
"jwt": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}
}
You can also log in with username or login instead of email. For the full reference, see Authentication.
5. Use the JWT
Send the token in the Authorization header:
curl "https://example.com/wp-json/simple-jwt-login/v1/auth/validate" \
-H "Authorization: Bearer YOUR_JWT"
The validate endpoint returns the user the token belongs to, so it is a quick way to check that everything works.
To use the token with the WordPress REST API (such as /wp/v2/posts or /wp/v2/users/me) or with your own endpoints, enable JWT Middleware for all WordPress endpoints under General → Integration Options. WordPress then treats every request with a valid JWT as coming from that user:
curl "https://example.com/wp-json/wp/v2/users/me" \
-H "Authorization: Bearer YOUR_JWT"
The plugin can also read the JWT from a query parameter, the request body, a cookie, or the session - see JWT Input Sources.
Handling errors
Plugin endpoints return errors in this shape. Branch on data.error_code, not on the message text (errors on other REST routes use the WordPress error format, with the code in the same data.error_code field):
{
"success": false,
"data": {
"message": "Wrong user credentials.",
"error_code": 48
}
}
Look up any code in Error codes.
Next steps
- Keep users logged in - enable refresh tokens and revoke tokens on logout.
- Lock down the REST API - require a JWT, or a specific role, for any route with Protect Endpoints.
- Call from a browser - configure CORS for your front-end origin.
- Let users sign up - enable Register User.
- Social login - exchange Google, Auth0, Facebook, or GitHub tokens for a WordPress JWT with OAuth.
- Server-to-server calls - use API keys instead of user passwords.
- See every endpoint - Endpoints overview.
- Full working apps - Code examples.