POSTPublic

Social login

/api/v1/social-auth

Exchange a Google or Facebook OAuth access token for a DKBSign session. Same success shape as password login without MFA (user + access_token).

Path parameters

This endpoint has no path parameters.

Query parameters

This endpoint has no query parameters.

Request body

Field	Type	Description
provider Required	string	`google` or `facebook`. e.g. "google"
access_token Required	string	OAuth access token from the provider. e.g. "ya29.a0AfH6SMB..."

Responses

Status	Meaning
200	Logged in successfully
401	Missing or invalid Bearer token.

Request

curl

curl -X POST 'https://api.dkbsigns.com/api/v1/social-auth' \
  -H 'Content-Type: application/json' \
  -d '{"provider":"google","access_token":"ya29.a0AfH6SMB..."}'

Response 200

json

{
  "status": "success",
  "message": "Logged in successfully",
  "data": {
    "user": {
      "id": 4,
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "user@acme.test",
      "role": "user",
      "company_id": 1,
      "job_title": "Chief Financial Officer",
      "locale": "fr",
      "seal": null,
      "signature_mentions": {
        "enabled": true,
        "frame": false,
        "mentions": [
          "fullName",
          "jobTitle"
        ]
      },
      "is_available": true
    },
    "access_token": "1|abcdefghijklmnopqrstuvwxyz"
  }
}