---
title: "Send Instagram DM"
method: POST
path: "/uploadposts/dms/send"
tags: ["Instagram Interactions"]
---

# Send Instagram DM

`POST /uploadposts/dms/send`

Send a direct message to an Instagram user using their IGSID. The recipient must have messaged your account first (24-hour messaging window policy enforced by Meta).

## Request body

- object
  - `platform` 'instagram', required — Must be 'instagram'.
  - `user` string, required — Profile username as configured in Upload-Post.
  - `recipient_id` string, required — Instagram-Scoped User ID (IGSID) of the recipient.
  - `message` string, required — The text message to send.
  - `buttons` object[] — Up to 3 web_url buttons rendered in the Instagram DM.
    - `title` string, required — Button label (max 20 chars).
    - `url` string, uri, required — Destination URL (http/https).

## Response `200`

DM sent successfully.

- object
  - `success` boolean
  - `recipient_id` string
  - `message_id` string
  - `message` string

## Other responses

- `400` — Missing fields or invalid account.
- `429` — Daily DM limit exceeded.
- `500` — Internal server error.

## Changes

- **2026-07-26** `b25e2a444745` — 1 info
  - added the new optional request property `buttons`

[Change history](https://skmtc.dev/upload-post/apis/upload-post-api/changes/uploadposts/dms/send/post.md)

---

[API](https://skmtc.dev/upload-post/apis/upload-post-api.md) · [All operations](https://skmtc.dev/upload-post/apis/upload-post-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/upload-post/upload-post-api/revisions/10bd964e4415/schema)