Skip to content

Reply to the customer

POST
/products/{productId}/tickets/{id}/replies
curl --request POST \
--url https://api.motenya.app/v1/products/example/tickets/example/replies \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "body": "example", "solve": true }'

Emailed to the requester from the ticket’s channel. Shown in the thread as written by this key.

Requires tickets:write.

productId
required
string
>= 1 characters <= 64 characters
id
required
string
>= 1 characters <= 64 characters
Media typeapplication/json
object
body
required

Markdown; emailed to the requester.

string
>= 1 characters <= 100000 characters
solve

Mark the ticket solved with this reply.

boolean

Example generated

{
"body": "example",
"solve": true
}

Success

Media typeapplication/json
object
ticket
required
object
id
required
string
>= 1 characters <= 64 characters
productId
required
string
>= 1 characters <= 64 characters
number
required
integer
subject
required
string | null
status
required
string
Allowed values: OPEN PENDING SOLVED CLOSED
priority
required
string
Allowed values: LOW NORMAL HIGH URGENT
source
required
string
Allowed values: EMAIL HELP_CENTER WIDGET
channelId
required
string | null
requester
required
object
id
required
string
>= 1 characters <= 64 characters
email
required
string
name
required
string | null
contactId
required

The CRM contact; null for a lead.

string | null
>= 1 characters <= 64 characters
storeIds
required
Array<string>
assigneeUserId
required
string | null
tags
required
Array<string>
mergedIntoTicketId
required
string | null
>= 1 characters <= 64 characters
createdAt
required
string
updatedAt
required
string
lastActivityAt
required
string
key
additional properties
message
required

REPLY adds sendState and sendError; EVENT adds change, merge and automatedReason.

object
id
required
string
>= 1 characters <= 64 characters
kind
required
string
Allowed values: CUSTOMER REPLY NOTE EVENT
fromAddress
required
string | null
fromName
required
string | null
authorUserId
required

The teammate, or apikey:<id> for a key.

string | null
subject
required
string | null
bodyText
required
string | null
bodyHtml
required
string | null
attachments
required
Array<object>
object
id
required
string
>= 1 characters <= 64 characters
filename
required
string | null
contentType
required
string
size
required
integer
key
additional properties
createdAt
required
string
key
additional properties

Example

{
"ticket": {
"status": "OPEN",
"priority": "LOW",
"source": "EMAIL"
},
"message": {
"kind": "CUSTOMER"
}
}

Invalid request

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Missing, invalid, revoked or expired API key

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Missing scope, API turned off, published article without publish scope, or account suspended

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Not found, or outside the knowledge bases this key may use

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Slug or translation already exists

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Rejected by validation (e.g. unknown language or category)

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Rate limited; see Retry-After

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Internal error