Authenticate a customer

Validates email + password credentials for a shop’s customer account. Returns the contact entity with a session token on success. Requires a Bearer token with customers.write scope (the same token used for all v2 requests) and shop_id in the request body.

POST/customers/sessions

Authorization

AuthorizationBearer token (JWT) · headerrequired

Request body

requiredapplication/json

shop_idintegerrequired

ID of the shop the customer belongs to.

emailstringrequired

passwordstringrequired

Responses

200

Authentication successful

422

Invalid credentials

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (JWT)Remember on this deviceInclude my values in samples

Bodyapplication/json

shop_idinteger*ID of the shop the customer belongs to.emailstring*passwordstring*

Request

curl -X POST 'https://api.onbolder.com/v2/customers/sessions' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "shop_id": 1,
  "email": "jane@example.com",
  "password": "s3cr3tpassword"
}'

const response = await fetch("https://api.onbolder.com/v2/customers/sessions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"shop_id\": 1,\n  \"email\": \"jane@example.com\",\n  \"password\": \"s3cr3tpassword\"\n}"
});

import requests

response = requests.post(
    "https://api.onbolder.com/v2/customers/sessions",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"shop_id\": 1,\n  \"email\": \"jane@example.com\",\n  \"password\": \"s3cr3tpassword\"\n}",
)

Response

{
  "id": 3001,
  "email": "jane@example.com",
  "name": "Jane Smith",
  "customer_status": "private",
  "token": "eyJhbGciOiJIUzI1NiJ9...",
  "_links": {
    "self": {
      "href": "https://api.onbolder.com/v2/customers/3001"
    }
  }
}