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.
Name | Type | | Description |
---|
definitionKey | string | Required | Unique identifier of the definition. |
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. |
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. |
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 |