POST Social Sign In

​

Signs a customer in with a social provider identity. Supported providers are google, apple and facebook.

Despite the name, this is a full sign-in, not a lookup — on success it returns a customer token and opens a session, exactly like POST /customers/login.

Use it as the first step of a social flow: a 200 means the identity is already linked, so continue as signed in. A 401 means it is not linked yet — send the customer to POST /customers/social-sign-up.

Unavailable for brands using an external identity provider.

Headers

  • Type of content accepted by the API (application/json in most cases)

  • Application key for specific client app

  • Content-Type header

  • Version of the API to be used

  • Unique request identifier

Body

required
application/json
  • Properties: 2
  • Optional device details recorded on the session

  • Used only as a fallback lookup on brands that import customers from their loyalty platform

Responses

  • application/json
  • No customer account is linked to that social identity - route the customer to social sign-up.

  • The brand uses an external identity provider, so MENU customer auth is unavailable.

Request Example for post/customers/social-check
curl https://api-public-demo.menu.app/api/customers/social-check \
  --request POST \
  --header 'Accept: application/json' \
  --header 'Application: application-key' \
  --header 'Content-Type: application/json' \
  --header 'API-VERSION: ' \
  --header 'X-Request-ID: c10b4a70-6274-490d-80a0-03e7bb826937' \
  --data '{
  "provider": {
    "social_id": "1234567890",
    "type": "google"
  },
  "email": "ada@example.com"
}'
{
  "status": "OK",
  "code": 200,
  "data": {
    "customer_account": {
      "id": 9031,
      "brand_id": 57,
      "first_name": "Ada",
      "last_name": "Lovelace",
      "email": "ada@example.com",
      "is_social": true
    },
    "token": {
      "ttl": 60,
      "refresh_ttl": 20160,
      "issued_token_type": "access_token",
      "token_type": "Bearer",
      "value": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
    },
    "dlc_access_token": null
  }
}