---
title: "Connect a LinkedIn account"
method: POST
path: "/v1/actions/connect_linkedin"
tags: ["Account"]
---

# Connect a LinkedIn account

`POST /v1/actions/connect_linkedin`

## Request

- Base URL: `https://api.heyreagent.com`
- URL: `https://api.heyreagent.com/v1/actions/connect_linkedin`
- Auth: HTTP bearer

Get a private link where you sign a LinkedIn account in.

No account exists until the person finishes the form behind url. Then list_linkedin_accounts lists it.

The link works for 2 hours.

Docs: https://heyreagent.com/docs/actions/connect_linkedin

## Request body

- object
  - `label` string: Optional friendly name to pre-fill for this sender.
  - `country` string: Optional country to pre-select — a name token (e.g. "UNITED_STATES", "UNITED_KINGDOM") or a 2-letter ISO code (e.g. "us", "gb"); the user can change it on the form.

## Response `200`

It worked. Inside result: url, expiresInHours, instructions.

- Worked
  - `ok` true, required
  - `result` object, required: What was asked for. A field that does not apply is left out, or is null.

## Other responses

- `default`: It did not work. The message says why, in plain English.

---

[API](https://skmtc.dev/heyreagent/apis/heyreagent-api.md) · [All operations](https://skmtc.dev/heyreagent/apis/heyreagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heyreagent/apis/heyreagent-api/revisions/917360c5f841?raw)