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: stringrequired
Type of content accepted by the API (application/json in most cases)
- Type: stringrequired
Application key for specific client app
- Type: stringrequired
Content-Type header
- Type: stringrequired
Version of the API to be used
- Type: stringrequired
Unique request identifier
Body
- Properties: 2Type: objectrequired
- Type: object
Optional device details recorded on the session
- Type: stringFormat: email
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.
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
}
}