PATCH /messaging/v1/sms/definitions/{definitionKey}

Updates a specific message definition. It can take up to two minutes for outbound messages to reflect the changes.

URL Parameters

Name	Type		Description
definitionKey	string	Required	Unique identifier of the definition.

JSON Parameters

Name	Type		Description
name	string	Required	Name of the definition. Must be unique.
content.message	string	Required	The message content that you want sent with each message. Use substitution strings and AMPscript to personalize the message.
status	string		Operational state of the definition: active, inactive, or deleted. A message sent to an active definition is processed and delivered. A message sent to an inactive definition isn’t processed or delivered. Instead, the message is queued for later processing for up to three days.
description	string		User-provided description of the send definition.
subscriptions.shortCode	string	Required	The short or long code for the mobile transmissions for each message on this definition.
subscriptions.countryCode	string		The country code associated with the shortCode for the mobile transmissions for each message on this definition. Don't use for long codes, unless your account configuration requires it.
subscriptions.keyword	string		The keyword used to track messages
subscriptions.autoAddSubscriber	boolean		Permits adding a recipient as subscriber against the shortCode using contactKey. When false, the message is rejected if contactKey does not exist as a subscriber. Default is true.

Responses

Status	Name	Type	Description
200			Send definition is updated. Review example response.
	requestId	string	The unique identifier of this request.
	name	string	Name of the definition.
	definitionKey	string	Unique, user-generated key to access the definition object.
	definitionId	string	Unique Marketing Cloud object identifier.
	description	string	User-provided description of the send definition.
	status	string	Operational state of the definition: active, inactive, or deleted. A message sent to an active definition is processed and delivered. A message sent to an inactive definition isn’t processed or delivered. Instead, the message is queued for later processing for up to three days.
	createdDate	string	Date the definition was created.
	modifiedDate	string	Date and time the definition was most recently changed.
	content.message	string	The message content that you want sent with each message. Use substitution strings and AMPscript to personalize the message.
	subscriptions.shortCode	string	The short or long code for the mobile transmissions for each message on this definition.
	subscriptions.countryCode	string	The country code associated with the shortCode for the mobile transmissions for each message on this definition. Don't use for long codes, unless your account configuration requires it.
	subscriptions.keyword	string	The keyword used to track messages
	subscriptions.autoAddSubscriber	boolean	Allows you to add a recipient as subscriber against the shortCode using contactKey. When false, the message is rejected if contactKey doesn’t exist as a subscriber. Default is true.
	subscriptions.updateSubscriber	boolean	Updates the recipient subscriber data including mobile number. Default is true.

Example Request

Example Response

HTTP Responses

Response	Reason
200 OK	Send definition is updated. Review example response.
400 Bad Request	Invalid request
403 Forbidden	Failed to pass authorization.
500 Server Error	Internal error