---
title: "Create a ticket in a connected project-management tool"
method: POST
path: "/api/v1/integration/create-ticket"
tags: ["Integration"]
---

# Create a ticket in a connected project-management tool

`POST /api/v1/integration/create-ticket`

## Request

- Base URL: `https://toolkit.browserstack.com`
- URL: `https://toolkit.browserstack.com/api/v1/integration/create-ticket`
- Auth: API key in cookie `_wdt_rails_session`

Reports a Visual Overlay finding as a ticket through the central integrations service. The description arrives as plain lines (plus an optional link) and is converted to the rich-doc format the tool expects.

## Request body

- object
  - `integration_key` string
  - `fields` object, required
    - `organisation_id` string
    - `project_id` string, required
    - `ticket_type_id` string, required
    - `summary` string, required
  - `description_lines` string[]
  - `link` object
    - `text` string
    - `uri` string

## Response `201`

Ticket created

- object
  - `external_id` string
  - `external_url` string

## Other responses

- `401`: Tool connection lapsed
- `422`: Ticket refused

---

[API](https://skmtc.dev/birdeatsbug/apis/wdt-rails-api.md) - [All operations](https://skmtc.dev/birdeatsbug/apis/wdt-rails-api/llms.txt) - [OpenAPI document](https://skmtc.dev/birdeatsbug/apis/wdt-rails-api/revisions/cbd06b547b6a?raw)