TItidio
Tickets

Create ticket (as Contact)

This API endpoint creates a ticket as Contact based on the data provided.

post/tickets/as-contact

Request

  • Base URL
    https://api.tidio.com
  • URL
    https://api.tidio.com/tickets/as-contact
  • Auth
    API key in header X-Tidio-Openapi-Client-Id and API key in header X-Tidio-Openapi-Client-Secret

Request body

contact_emailstring email required

Email of contact person

subjectstring required

Subject of ticket

message_contentstring required

First ticket message content

assigned_department_idstring uuid nullable

ID of assigned Department. When not provided, then the General department is assigned as default.

custom_channel_idstring nullable

ID of custom channel to attach to given ticket.

tag_idsinteger[] nullable

List of tag IDs to attach to the ticket.

Example request

{
  "contact_email": "user@tidio.com",
  "subject": "Question about delivery",
  "message_content": "Is it possible to ship the product to the USA?",
  "assigned_department_id": "24f59f95-7c5e-434f-affe-b05a8772ef45",
  "custom_channel_id": "01K7PCM5YJHGH8G72MGFK36WKY",
  "tag_ids": [
    1,
    2,
    3
  ],
  "custom_fields": [
    {
      "id": "01HF8N4A2B3C4D5E6F7G8H9J0K",
      "value": "Priority reason text"
    }
  ]
}

Response

Entity was created and their id is returned

idinteger

Example response

{
  "id": 10000
}

Changes

No recorded changes to this operation across all 1 revision of this API.