---
title: "Send a Message"
method: POST
path: "/message/send"
tags: ["messages"]
---

# Send a Message

`POST /message/send`

This will send a message to one or more objects.

## Request body

- MessageSend
  - `objectID` integer, required — Object type ID of the object to mail to
  - `criteria` Criteria
    - `objectID` integer, required
    - `ids` integer[]
    - `condition` string — [See the Criteria examples below](https://api.ontraport.com/live/#!/Criteria/Examples)
    - `sort` string — Field used to sort results
    - `sortDir` 'asc' | 'desc' — Sort direction, must be used in conjunction with <b>sort</b> parameter.
    - `range` integer — Number of results to return (maximum=50)
    - `start` integer — Return results starting at this offset
    - `group_id` integer — Group ID as an integer
    - `search` string — Search Objects for this string
    - `searchNotes` string — Boolean flag to additionally search Object Notes for the Search term given in Search parameter
    - `externs` string — External fields to include in results
    - `listFields` string[] — Return only these fields in the response
    - `event_id` integer — Optional parameter for calendar event composite ID
  - `message` Message
    - `object_type_id` integer — Object type ID of the object to mail to
    - `subject` string
    - `type` string
    - `from` string
    - `send_out_name` string
    - `reply_to_email` string
    - `send_from` string
    - `email_title` string
    - `transactional_email` integer
    - `message_body` string
    - `message_id` integer

## Response `200`

Successfully sent messages

- Response
  - `code` integer, required
  - `data` object, required
  - `account_id` integer, required

## Other responses

- `400` — Error sending messages
- `403` — No permissions

---

[API](https://skmtc.net/ontraport/apis/ontraport-api.md) · [All operations](https://skmtc.net/ontraport/apis/ontraport-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ontraport/ontraport-api/revisions/edcd035d71f5/schema)