Social auth callback

POST

api

social_auth

callback

curl --request POST \
  --url https://api.fluid.app/api/social_auth/callback \
  --header 'Content-Type: application/json' \
  --data '
{
  "provider": "google",
  "code": "4/0AWtgzh4kK9m2Qw",
  "state": "3f2a9c7e1b",
  "fluid_shop": "myco.fluid.app"
}
'

{
  "multi_factor_authentication": {
    "uuid": "<string>",
    "verification_channel": "<string>",
    "authenticated": true,
    "verification_code": "<string>",
    "verification_code_expires_at": "2023-11-07T05:31:56Z"
  },
  "user": {
    "id": 123,
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>"
  },
  "customer": {
    "id": 123,
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>"
  },
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Body

application/json

provider

enum<string>

required

Available options:

google,

facebook,

apple

code

string

required

OAuth authorization code returned by the provider.

state

string

Server-issued, one-time OAuth state (validated and consumed for Google/Apple).

fluid_shop

string

Shop context for the login; falls back to the verified state or the request domain.

user

string

JSON string of user data Apple posts on first authorization.

id_token

string

Apple ID token; decoded to extract the sub claim.

Response

Success

multi_factor_authentication

object

required

Show child attributes

auth_type

enum<string>

required

Available options:

user,

customer,

rep

user

object

The user or customer resolved from a social-auth callback.

Show child attributes

customer

object

The user or customer resolved from a social-auth callback.

Show child attributes

meta

object

Show child attributes

Redirect to Apple OAuth

Redirect to Facebook OAuth

curl --request POST \
  --url https://api.fluid.app/api/social_auth/callback \
  --header 'Content-Type: application/json' \
  --data '
{
  "provider": "google",
  "code": "4/0AWtgzh4kK9m2Qw",
  "state": "3f2a9c7e1b",
  "fluid_shop": "myco.fluid.app"
}
'

{
  "multi_factor_authentication": {
    "uuid": "<string>",
    "verification_channel": "<string>",
    "authenticated": true,
    "verification_code": "<string>",
    "verification_code_expires_at": "2023-11-07T05:31:56Z"
  },
  "user": {
    "id": 123,
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>"
  },
  "customer": {
    "id": 123,
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>"
  },
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Overview

Task guides

Endpoints

Auth endpoints

Checkout endpoints

Public SDK endpoints

Payment gateway endpoints

Cart payment endpoints

Commerce endpoints

Webhooks endpoints

Social auth callback

Body

Response