---
title: "Start authenticated social link REST API | HitKeep"
description: "Reference for the HitKeep REST API operation Start authenticated social link, including request parameters, responses, and authentication notes."
canonical: "https://hitkeep.com/api/operations/apiusersecuritysocialproviderstart/"
---

# Start authenticated social link REST API

POST

/api/user/security/social/{provider}/start

FetchcURL

```
const url = 'http://127.0.0.1:25737/api/user/security/social/google/start';
const options = {
  method: 'POST',
  headers: {cookie: 'hk_token=<hk_token>', 'Content-Type': 'application/json'},
  body: '{}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```
curl --request POST \
  --url http://127.0.0.1:25737/api/user/security/social/google/start \
  --header 'Content-Type: application/json' \
  --cookie hk_token=<hk_token> \
  --data '{}'
```

-

Starts a provider authorization bound to the authenticated HitKeep account.

## Authorizations

- **[cookieAuth](https://hitkeep.com/api/#cookieauth)**

## Parameters

### Path Parameters

**provider**

required

string

Allowed values: google github microsoft

## Request Bodyrequired

application/json

object

##### Examplegenerated

```
{}
```

## Responses

### 200

Provider authorization URL

application/json

object

**auth_url**

required

string format: uri

##### Examplegenerated

```
{
  "auth_url": "https://example.com"
}
```

### 404

Provider unavailable

application/json

object

**message**

string

##### Examplegenerated

```
{
  "message": "example"
}
```

[Previous Unlink social provider](https://hitkeep.com/api/operations/apiusersecuritysocialprovider/)[Next Disable TOTP](https://hitkeep.com/api/operations/apiusersecuritytotpdisable/)