POST /push/v1/messageTag/{messageId}/send

Overview

Sends a push message to users with the specified tags.

**URL Parameters**
Name	Type		Description
messageID	string	Required	The ID of the triggered send definition configured for MessageSend sending used for the send

**JSON Parameters**
Name	Type		Description
inclusionTags	array	Required	Tags used to identify contacts that will receive the message
exclusionTags	array		Tags used to identify contacts that will not receive the message
override	boolean		Flag to indicate that the contact is to receive the messageText as provided instead of the message's original text
messageText	boolean		Text value to be used in place of the message's original text. This value is required when override is true.
title	string		The title to be used in place of the message's original title.
subtitle	string		The subtitle to be used in place of the message's original subtitle.
mutable-content	boolean		If true, rich push functionality is enabled for the message.
sendTime	date		Date formatted yyyy-MM-dd HH:mm specifying a time in the future to send the message
blackoutWindow	string		Blackout window definition used to delay message sending outside a given windowStart and windowEnd and utcOffset
sound	string		Sound filename to be played on the device
badge	string		For iOS SDK version 4.9.5 and newer: Overrides the value on the push message definition. Badge count displays this number in a badge on the app and increments this number by one for each new unread message. For older iOS SDK versions: Overrides the value on the push message definition. Badge count does not increment.
openDirect	string		Value used as the open direct destination
customPayload	string		Custom definition in escaped JSON
customKeys	array		An array of key/value pairs used as custom keys to be sent with the message request body

Usage

Example Request


Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
POST /push/v1/messageTag/OEl8ODow/send
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

{
    "InclusionTags": ["Midwest"],
    "ExclusionTags": ["Indiana, Ohio"],
    "Override": true,
    "MessageText": "New information available!",
    "title": "Boost your winnings!",
    "subtitle": "Check your app to see what else is in store.",
    "mutable-content": 1,
    "SendTime": "2012-10-31 09:00",
    "Sound": "MyFile.caf",
    "Badge": "+1",
    "OpenDirect": "OD01",
    "CustomKeys": {"keyA": "keyA_value","keyB": "keyB_value" },
    "CustomPayload": { "customA": "customA_value" }
}

Example Response

HTTP/1.1 200
{
    "tokenId": "TokenIDValue"
}

Last Updated: Jun 8, 2021

Marketing Cloud API

POST /push/v1/messageTag/{messageId}/send

Overview

URL Parameters

JSON Parameters

Usage