---
title: "List my connections"
method: POST
path: "/v1/actions/list_connections"
tags: ["Network"]
---

# List my connections

`POST /v1/actions/list_connections`

## Request

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

List your 1st-degree connections.

connections[].connectionId is YOUR account the person is connected to, not the person.

No member id comes back. Pass profileUrl on; a action that needs the id resolves it, or get_profile_details returns it.

Served from a stored copy up to 24 hours old; refresh true reads LinkedIn again.

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

## Request body

- object
  - `connectionId` string: Restrict to one LinkedIn sender (its linkedinConnections _id from list_linkedin_accounts). Omit to merge across all your live senders in this setup.
  - `since` string: ISO date (e.g. "2026-01-01"). Only return connections made on/after this date.
  - `search` string: Case-insensitive substring matched against each person's name and headline.
  - `limit` number: Max people to return (1–500, default 200). The total match count is always reported even when truncated.
  - `refresh` boolean: true = pull the latest connections live from LinkedIn and refresh the cache (slower). false (default) = serve from cache, refreshing live only when the cache is empty or stale.

## Response `200`

It worked. Inside result: summary, connections, note.

- 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)