# OneShot Agent LinkedIn Invite

> OneShot Agent LinkedIn Invite is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-11).

Sends a LinkedIn connection invitation to a specified profile, optionally with a personalized note, via an autonomous agent account.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/linkedin/invite?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-linkedin-invite-24fd0a52
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JifVC1f4HySH8KzuKbV_P

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability oneshot-agent-linkedin-invite-24fd0a52 -d '<json body>'
```

Example prompt: Send a LinkedIn connection request to https://linkedin.com/in/jane-doe with the note 'Hi Jane, I'd love to connect and discuss opportunities in AI — I've been following your work at Acme Corp.'

## When to prefer this

Use this endpoint when you need to programmatically send LinkedIn connection invitations at scale, particularly in automated outreach, recruiting, or sales workflows. It is the right choice when you need an async, agent-friendly LinkedIn invite mechanism with a payment rail (x402) rather than managing OAuth credentials directly with LinkedIn's API.

## Known failure modes

- Invalid or non-existent LinkedIn profile URL returns an error status on polling
- Payment failure or missing x402 authorization header returns 402 Payment Required
- Rate limiting or LinkedIn account restrictions may prevent invitation delivery
- Duplicate connection request to an already-connected profile may result in an error
- Missing required 'profile' field causes a 400 Bad Request
- Polling timeout if LinkedIn's API is slow to confirm the invitation

## How this service works

Tools, payments, and compute orchestration for autonomous AI agents.

## Authentication

- **`x402Payment`** — paid tool endpoints use the [x402 payment protocol](https://x402.io).
  First call returns `402 Payment Required` with a quote; sign and resend the request
  with `Authorization: <signed payment header>` and `X-Quote-ID: <quote_id>`.
- **`agentId`** — free read-only endpoints accept `X-Agent-ID: <wallet>` (0x… address).
- **`soulKey`** — soul marketplace seller dashboard uses `Authorization: Bearer soul_…`
  (issued by `POST /v1/soul/register`).
- **`acpBearer`** — Stripe ACP checkout sessions use a separate bearer token plus the
  `API-Version: 2026-01-30` header.

## Async tools & polling

Most tool endpoints return `202 Accepted` with `{ request_id, tool, status }`. Poll
`GET /v1/requests/{id}` (with the same `X-Agent-ID`) to retrieve the final result.
A WebSocket fallback is available at `wss://<host>/v1/requests/subscribe`.

## Pricing

See [docs.oneshotagent.com/pricing](https://docs.oneshotagent.com/pricing) for the full
table. Per-call costs for this environment, rendered from the same config the routes bill from:

| Tool | Cost |
|---|---|
| Web search | $0.001 |
| Web read | $0.002 |
| Research | $0.01 |
| Person enrichment | $0.005 |
| Email verification | $0.001 |
| Deep research (person) | $0.05 |
| Social profiles | $0.50 |
| Local business search | $0.01 |
| Commerce search | $0.002 |
| LinkedIn history sync | $0.02 per bounded run |
| LinkedIn reply | $0.02 per message |
| LinkedIn profile view | $0.01 per view |
| LinkedIn post reaction | $0.01 per reaction |
| Email send | quote-based; service fee from $0.005 per send |
| SMS send | $0.0035 per segment per recipient |
| Voice call | $0.35/minute + $5.00 number registration on the first call |
| Browser task | quote-based; minimum $0.005 |
| Website build | quote-based; from $1.00 |
| Compute goal | quote-based; minimum budget $1.00 + 20% platform fee |

## Error format

`{ "error": "<machine_code>", "message": "<human readable>", "details": <optional> }`.
Validation errors include a `details` field with the failing field paths.

## Output

Returns a 202 Accepted response with a request_id, the tool name, and a 'processing' status. The invitation_id (UUID) from LinkedIn is included in the response body. Poll GET /v1/requests/{request_id} with the same agent ID to confirm final delivery status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "note": {
   "type": "string"
  },
  "profile": {
   "type": "string"
  },
  "account_id": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "processing",
  "linkedin": {
   "invitation_id": "uuid"
  },
  "request_id": "uuid"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-linkedin-invite-24fd0a52/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)