# Send a connection invitation

### Send a connection invitation

`POST /api/v1/linkedin/invitations`

Operation ID: `sendLinkedinInvitation`

Sends a connection invitation with an optional note of up to 300 characters. Fails if the recipient is already connected or has an invitation pending.

**Request body** (required)

- `connectedAccountId` (string · uuid, required): Connected account to act as
- `identity` (string, required): User id (ACoAAA…) or public identifier.
- `note` (string, optional)

**201**: Invitation result.

- `result` (object, required)
  - `invitationId` (string | null, required)
  - `sentAt` (string · date-time, required)
- `remainingUsage` (object, required): Remaining allowance for this action on the connected account across hourly, daily, and weekly windows. Each action type has its own limits.
  - `hour` (integer | null, required): Remaining hourly allowance for this action. Null when this action has no hourly cap.
  - `day` (integer, required): Remaining daily allowance for this action.
  - `week` (integer | null, required): Remaining weekly allowance for this action. Null when this action has no weekly cap.
- `requestId` (string · uuid, required): Id of this request, for support and troubleshooting

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload