---
title: "Link social login"
method: POST
path: "/v1/auth/link-social-login"
tags: ["Authentication"]
---

# Link social login

`POST /v1/auth/link-social-login`

## Request

- Base URL: `https://api.assinafy.com.br`
- URL: `https://api.assinafy.com.br/v1/auth/link-social-login`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Link a social-login provider account to the authenticated user.

[Copy as Markdown](https://api.assinafy.com.br/v1/docs/markdown?method=post&path=%2Fv1%2Fauth%2Flink-social-login) [Open in ChatGPT](https://chatgpt.com/?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dpost%26path%3D%252Fv1%252Fauth%252Flink-social-login%20and%20help%20me%20integrate%20this%20endpoint.) [Open in Claude](https://claude.ai/new?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dpost%26path%3D%252Fv1%252Fauth%252Flink-social-login%20and%20help%20me%20integrate%20this%20endpoint.)

## Request body

- object
  - `provider` 'google', required
  - `token` string, required: Token from the provider.

## Response `200`

Provider linked

- Envelope: Standard success wrapper. Operations add their own `data`.
  - `status` integer: HTTP status code, mirrored in the body.
  - `message` string: Human-readable message; empty on success.

## Other responses

- `400`: One or more fields failed validation.
- `401`: Missing or invalid credentials.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/assinafy/apis/assinafy-api-reference.md) - [All operations](https://skmtc.dev/assinafy/apis/assinafy-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/assinafy/apis/assinafy-api-reference/revisions/f7da81a5567e?raw)