---
title: "Schedule Dm To Person"
method: POST
path: "/mcp/tools/schedule_dm_to_person"
tags: ["mcp"]
---

# Schedule Dm To Person

`POST /mcp/tools/schedule_dm_to_person`

## Request

- Base URL: `https://api.iridiumhqmcp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.iridiumhqmcp.com/mcp/tools/schedule_dm_to_person`
- Auth: HTTP bearer

Send or schedule a direct message to a person named in plain English. THIS SENDS.

Resolves the name itself: it checks existing conversations, then saved profiles, then
LinkedIn search. The response carries a `confidence` field. When it is low, confirm the
match with the user before the message goes out rather than trusting the resolution.

USE THIS when the user names someone and no chat_ handle is at hand.
DO NOT USE when you already have a chat_ handle. Use schedule_manual_dm instead.

Args:
    name: the person's name as the user said it.
    text: the exact message to send.
    send_at: "now" to send immediately, or ISO-8601 with an offset.
    profile_handle: prof_ handle, to skip resolution when it is already known.

## Request body

- ScheduleDmToPersonRequest
  - `name` string, required
  - `text` string, required
  - `send_at` string, nullable
  - `profile_handle` string, nullable
  - `message_type` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/iridiumhqmcp/apis/iridium-linkedin-for-ai-agents.md) · [All operations](https://skmtc.dev/iridiumhqmcp/apis/iridium-linkedin-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/iridiumhqmcp/apis/iridium-linkedin-for-ai-agents/revisions/b9f5e020543c?raw)