---
title: "Send a direct message"
method: POST
path: "/api/v1/messages"
tags: ["Messages"]
---

# Send a direct message

`POST /api/v1/messages`

## Request

- Base URL: `https://app.tryadeli.com`
- URL: `https://app.tryadeli.com/api/v1/messages`
- Auth: HTTP bearer

## Request body

- union
  - object
    - `platform` 'instagram', required
    - `accountId` string, uuid, required
    - `profileId` string, uuid
    - `recipient` string, required
    - `text` string, required
  - object
    - `platform` 'facebook', required
    - `accountId` string, uuid, required
    - `profileId` string, uuid
    - `recipient` string, required
    - `text` string, required
  - object
    - `platform` 'whatsapp', required
    - `accountId` string, uuid, required
    - `profileId` string, uuid
    - `recipient` string, required
    - `template` object, required
      - `name` string, required
      - `language` string, required
      - `bodyParameters` string[]

## Response `201`

Success

- object

## Other responses

- `400`: Invalid request, or no profile named
- `401`: Missing or invalid API key
- `403`: The connection is healthy but lacks a permission or provider-confirmed resource this feature requires. Restart OAuth using the structured guidance.
- `404`: Profile, account, or object not found
- `422`: The connected account cannot do this because credentials expired or the platform is unsupported
- `502`: The platform's API failed

---

[API](https://skmtc.dev/tryadeli/apis/adeli-api.md) · [All operations](https://skmtc.dev/tryadeli/apis/adeli-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tryadeli/apis/adeli-api/revisions/7b8012dc8477?raw)