post https://api.kustomerapp.com/v1/conversations
Creates a new conversation.
Any one of the following roles is required for this endpoint:
Legacy Role | Equivalent Permission Set Role |
---|---|
org.user.conversation.write | org.permission.conversation.create |
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 nullAt
date-time or nullStr
string or null, length: [ 0 .. 1024 ] charactersTxt
string or null, length: [ 0 .. 1024 ] charactersBool
boolean or nullUrl
string or null, format: uri
Rate Limit
Conversations are subject to a rate limit. A single client can create up to 120 conversations per minute per customer.
Conversations with importedAt
in their body will not be subject to the rate limit.
A 429 Too Many Requests
response will be returned if the rate limit has been reached for a customer.