Update message attributes by ID

Updates attributes for a message based on the unique message ID.

Any one of the following roles is required for this endpoint:

Legacy RoleEquivalent Permission Set Role


This endpoint is subject to Object Rate Limiting, which limits how many updates single user can make to a single message. To learn more, see Rate limiting.


The org.admin role is required for setting createdAt, createdBy, modifiedAt, and modifiedBy. Otherwise, these attributes are automatically set by the token.

Custom Attributes

Custom attributes are optional and allow you to specify custom key-value pairs.

Kustomer uses a naming convention for custom attributes to specify the field data type with a name suffix:

Naming Suffix

  • Num number or null
  • At date-time or null
  • Str string or null, length: [ 0 .. 1024 ] characters
  • Txt string or null, length: [ 0 .. 1024 ] characters
  • Bool boolean or null
  • Url string or null, format: uri
Click Try It! to start a request and see the response here!