Create Ticket

Create a new ticket. Not every channel that accepts replies can have a ticket opened on it: opening one has to create a real conversation on the marketplace, which is verified for Kaufland, Fnac, Veepee and Mirakl but not for Cdiscount, TikTok Shop, Reverb or Backmarket. Creating a ticket on one of those returns error code 4013 - reply to the imported ticket with POST /messages instead.

On Mirakl the first message opens a thread against the order the ticket carries, addressed to the recipients named by the channel's "Default messages recipients" setting. A Mirakl channel with that setting still at "Not selected" could never deliver a reply, so creating a ticket on it returns error code 4024 - see POST /messages for where to set it.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
integer
required

Channel to open the ticket on. Cdiscount, TikTok Shop, Reverb and Backmarket accept replies but cannot have a ticket created on them; doing so returns error code 4013. A Mirakl channel additionally needs its "Default messages recipients" setting filled in, otherwise it returns error code 4024.

string
enum
required
Allowed:
integer

Mandatory when the channel is Kaufland, Fnac, Veepee or Mirakl - those marketplaces cannot open a conversation without the order it relates to, so a ticket created without one could never be replied to. Omitting it returns error code 4023.

string
boolean | null

If true (default), the response will contain the full ticket object

custom_fields
array of objects

Array of CustomField items

custom_fields
integer

Consumer ID

contact
object

Consumer model

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json