curl --request POST \
  --url https://api.usepylon.com/issues \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "account_id": "<string>",
  "requester_id": "<string>",
  "requester_email": "<string>",
  "requester_name": "<string>",
  "requester_avatar_url": "<string>",
  "title": "<string>",
  "body_html": "<string>",
  "assignee_id": "<string>",
  "priority": "<string>"
}'
{
  "custom_fields": [
    {
      "slug": "<string>",
      "value": true,
      "values": true
    }
  ],
  "destination_metadata": {
    "destination": "<string>",
    "email": "<string>"
  }
}

Create a new tracked issue in Pylon.

Use Cases

  1. Use the API to create issues programatically on behalf of customers. Create issues from custom frontends or unique sources.

  2. Create issues from backend-triggered events. Proactively raise an internal support ticket when an issue with customer impact is detected.

Body Parameters

account_id
string
required

The account that this issue belongs to.

requester_id
string
required

The requester that this issue is on behalf of.

OR

requester_email
string
required

The email of the user that this issue is on behalf of.

requester_name
string
required

The full name of the user that this issue is on behalf of.

requester_avatar_url
string

The URL of an avatar of the requester.

AND

title
string
required

The title of the issue.

body_html
string
required

The HTML content of the body of the issue.

assignee_id
string

The user the issue should be assigned to.

priority
string

The priority of the issue. Can be one of urgent, high, medium, or low.

custom_fields
Custom Field[]
destination_metadata
object

Response

Example

{
    "data": {
        "id": "da7bac3f-f070-4106-9ee9-8aea27b36cf9",
        "title": "Need help with configuration!",
        "body_html": "<p>Hey team, I am running into some issues with my configuration - can I get some help?</p>",
        "state": "new",
        "account": {
            "id": "9bc51275-56d1-4dec-b908-8f3abf8a9792"
        },
        "assignee": {
          "id": "1a953adb-1cb6-45a2-845e-8e4f452815d7"
        },
        "requester": {
          "id": "bd992aa9-1c32-4073-88a9-681e7a915809"
        },
        "created_at": "2023-11-20T11:43:15-08:00"
    },
    "request_id": "5ee42efe-3ddc-4d0b-8d2f-443facf98753"
}