Identra Docs
Reference / Auth

Begin linking a social provider to the current user (OAuth linking mode). Authenticated: proves the session owner before binding, then returns the provider authorize URL for the SDK to navigate to (a full-page redirect couldn't carry the bearer). The callback attaches the returned identity to this user.

POST /v1/auth/me/identities/connect/{provider}
End-user session operationId: link_identity_start

Authorization

Called from the browser with the publishable application id (x-application-id); the access token lives in memory.

Path parameters

  • provider string required

    google | github | microsoft | ...

Request body · required

  • return_to string

Responses

200 Provider authorize URL
{
  "data": {
    "url": "string"
  },
  "error": {
    "code": "string",
    "message": "string"
  },
  "meta": {
    "timestamp": "string"
  },
  "success": false
}
401 No end-user session
422 Provider not enabled / not configured

Request

curl -X POST "https://api.identrahq.com/v1/auth/me/identities/connect/string" \
  -H "Content-Type: application/json" \
  -d '{
  "return_to": "string"
}'

Try it

live request
POST https://api.identrahq.com/v1/auth/me/identities/connect/string

Path parameters

Request body

application/json