Appends a message, addressing the ticket by the tracking key the create endpoint returned.

POST

/v1/integration/tickets/by-tracking-key/{trackingKey}/messages

curl --request POST \
  --url https://api.example.com/v1/integration/tickets/by-tracking-key/example/messages \
  --header 'Content-Type: application/json' \
  --data '{ "content": "example", "contentHtml": "example", "subject": "example", "attachmentIds": [ "example" ] }'

• Placeholder: replace with the API address of your own installation.

Identical to the by-id route; exists so a caller holding only a 202’s tracking key needs no extra round trip. That includes the closed-ticket continuation, the attachment rules, and both 409s: FD:3001 means this key was used with different content (do not retry), FD:3002 means an earlier request with it is still in flight (retry in a moment).

Parameters

Path Parameters

trackingKey

required

string

Header Parameters

Idempotency-Key

string

Request Body^required

object

content

string

nullable

contentHtml

string

nullable

subject

string

nullable

attachmentIds

Array

nullable

Example^generated

{
  "content": "example",
  "contentHtml": "example",
  "subject": "example",
  "attachmentIds": [
    "example"
  ]
}

object

content

string

nullable

contentHtml

string

nullable

subject

string

nullable

attachmentIds

Array

nullable

Example^generated

{
  "content": "example",
  "contentHtml": "example",
  "subject": "example",
  "attachmentIds": [
    "example"
  ]
}

object

content

string

nullable

contentHtml

string

nullable

subject

string

nullable

attachmentIds

Array

nullable

Example^generated

{
  "content": "example",
  "contentHtml": "example",
  "subject": "example",
  "attachmentIds": [
    "example"
  ]
}

Responses

200

OK

object

data

One of:

object

object

id

required

/^-?(?:0|[1-9]\d*)$/

ticketId

required

/^-?(?:0|[1-9]\d*)$/

trackingKey

required

string

createdAt

required

string format: date-time

continuedInNewTicket

required

boolean

parentTicketId

nullable /^-?(?:0|[1-9]\d*)$/

isReplay

required

boolean

success

boolean

error

One of:

object

object

status

/^-?(?:0|[1-9]\d*)$/

code

string

nullable

details

message

string

object

data

One of:

object

object

id

required

/^-?(?:0|[1-9]\d*)$/

ticketId

required

/^-?(?:0|[1-9]\d*)$/

trackingKey

required

string

createdAt

required

string format: date-time

continuedInNewTicket

required

boolean

parentTicketId

nullable /^-?(?:0|[1-9]\d*)$/

isReplay

required

boolean

success

boolean

error

One of:

object

object

status

/^-?(?:0|[1-9]\d*)$/

code

string

nullable

details

message

string

Example^generated

{
  "data": {
    "id": "example",
    "ticketId": "example",
    "trackingKey": "example",
    "createdAt": "2026-04-15T12:00:00Z",
    "continuedInNewTicket": true,
    "parentTicketId": "example",
    "isReplay": true
  },
  "success": true,
  "error": {
    "status": "example",
    "code": "example",
    "details": "example",
    "message": "example"
  }
}

object

data

One of:

object

object

id

required

/^-?(?:0|[1-9]\d*)$/

ticketId

required

/^-?(?:0|[1-9]\d*)$/

trackingKey

required

string

createdAt

required

string format: date-time

continuedInNewTicket

required

boolean

parentTicketId

nullable /^-?(?:0|[1-9]\d*)$/

isReplay

required

boolean

success

boolean

error

One of:

object

object

status

/^-?(?:0|[1-9]\d*)$/

code

string

nullable

details

message

string

Example^generated

{
  "data": {
    "id": "example",
    "ticketId": "example",
    "trackingKey": "example",
    "createdAt": "2026-04-15T12:00:00Z",
    "continuedInNewTicket": true,
    "parentTicketId": "example",
    "isReplay": true
  },
  "success": true,
  "error": {
    "status": "example",
    "code": "example",
    "details": "example",
    "message": "example"
  }
}

201

Created

object

data

One of:

object

object

id

required

/^-?(?:0|[1-9]\d*)$/

ticketId

required

/^-?(?:0|[1-9]\d*)$/

trackingKey

required

string

createdAt

required

string format: date-time

continuedInNewTicket

required

boolean

parentTicketId

nullable /^-?(?:0|[1-9]\d*)$/

isReplay

required

boolean

success

boolean

error

One of:

object

object

status

/^-?(?:0|[1-9]\d*)$/

code

string

nullable

details

message

string

object

data

One of:

object

object

id

required

/^-?(?:0|[1-9]\d*)$/

ticketId

required

/^-?(?:0|[1-9]\d*)$/

trackingKey

required

string

createdAt

required

string format: date-time

continuedInNewTicket

required

boolean

parentTicketId

nullable /^-?(?:0|[1-9]\d*)$/

isReplay

required

boolean

success

boolean

error

One of:

object

object

status

/^-?(?:0|[1-9]\d*)$/

code

string

nullable

details

message

string

Example^generated

{
  "data": {
    "id": "example",
    "ticketId": "example",
    "trackingKey": "example",
    "createdAt": "2026-04-15T12:00:00Z",
    "continuedInNewTicket": true,
    "parentTicketId": "example",
    "isReplay": true
  },
  "success": true,
  "error": {
    "status": "example",
    "code": "example",
    "details": "example",
    "message": "example"
  }
}

object

data

One of:

object

object

id

required

/^-?(?:0|[1-9]\d*)$/

ticketId

required

/^-?(?:0|[1-9]\d*)$/

trackingKey

required

string

createdAt

required

string format: date-time

continuedInNewTicket

required

boolean

parentTicketId

nullable /^-?(?:0|[1-9]\d*)$/

isReplay

required

boolean

success

boolean

error

One of:

object

object

status

/^-?(?:0|[1-9]\d*)$/

code

string

nullable

details

message

string

Example^generated

{
  "data": {
    "id": "example",
    "ticketId": "example",
    "trackingKey": "example",
    "createdAt": "2026-04-15T12:00:00Z",
    "continuedInNewTicket": true,
    "parentTicketId": "example",
    "isReplay": true
  },
  "success": true,
  "error": {
    "status": "example",
    "code": "example",
    "details": "example",
    "message": "example"
  }
}

401

Unauthorized

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

403

Forbidden

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

404

Not Found

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

409

Conflict

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

422

Unprocessable Entity

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

429

Too Many Requests

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}