Create Create

yaml
type: "io.kestra.plugin.zendesk.tickets.Create"

Opens new ticket at Zendesk.

Examples

Create Zendesk ticket using username and token.

yaml
id: zendesk_flow
namespace: company.team

tasks:
  - id: create_ticket
    type: io.kestra.plugin.zendesk.tickets.Create
    domain: mycompany.zendesk.com
    username: my_email@example.com
    token: zendesk_api_token
    subject: "Increased 5xx in Demo Service"
    description: |
      "The number of 5xx has increased beyond the threshold for Demo service."
    priority: NORMAL
    ticketType: INCIDENT
    assigneeId: 1
    tags:
      - bug
      - workflow

Create Zendesk ticket using OAuth token.

yaml
id: zendesk_flow
namespace: company.team

tasks:
  - id: create_ticket
    type: io.kestra.plugin.zendesk.tickets.Create
    domain: mycompany.zendesk.com
    oauthToken: zendesk_oauth_token
    subject: "Increased 5xx in Demo Service"
    description: |
      "The number of 5xx has increased beyond the threshold for Demo service."
    priority: NORMAL
    ticketType: INCIDENT
    assigneeId: 1
    tags:
      - bug
      - workflow

Create a ticket when a Kestra workflow in any namespace with company as prefix fails.

yaml
id: create_ticket_on_failure
namespace: company.team

tasks:
  - id: create_ticket
    type: io.kestra.plugin.zendesk.tickets.Create
    domain: mycompany.zendesk.com
    oauthToken: zendesk_oauth_token
    subject: Workflow failed
    description: |
      "{{ execution.id }} has failed on {{ taskrun.startDate }}.
      See the link below for more details."
    priority: NORMAL
    ticketType: INCIDENT
    assigneeId: 1
    tags:
      - bug
      - workflow
triggers:
  - id: on_failure
    type: io.kestra.plugin.core.trigger.Flow
    conditions:
      - type: io.kestra.plugin.core.condition.ExecutionStatusCondition
        in:
          - FAILED
          - WARNING
      - type: io.kestra.plugin.core.condition.ExecutionNamespaceCondition
        namespace: company
        comparison: PREFIX

Properties

domain

  • Type: string
  • Dynamic: ✔️
  • Required: ✔️

Zendesk domain url

assigneeId

  • Type: integer
  • Dynamic:
  • Required:

Id of assignee

description

  • Type: string
  • Dynamic: ✔️
  • Required:

Ticket description

oauthToken

  • Type: string
  • Dynamic: ✔️
  • Required:

Zendesk oauth token, if api token and username is not provided

priority

  • Type: string
  • Dynamic:
  • Required:
  • Possible Values:
    • URGENT
    • HIGH
    • NORMAL
    • LOW

Priority

Available values:

  • URGENT
  • HIGH
  • NORMAL
  • LOW

subject

  • Type: string
  • Dynamic: ✔️
  • Required:

Ticket subject

tags

  • Type: array
  • SubType: string
  • Dynamic: ✔️
  • Required:

List of tags for ticket

ticketType

  • Type: string
  • Dynamic:
  • Required:
  • Possible Values:
    • PROBLEM
    • INCIDENT
    • QUESTION
    • TASK

Ticket type

Available values:

  • PROBLEM
  • INCIDENT
  • QUESTION
  • TASK

token

  • Type: string
  • Dynamic: ✔️
  • Required:

Zendesk api token

username

  • Type: string
  • Dynamic: ✔️
  • Required:

Zendesk username

Outputs

id

  • Type: integer
  • Required:

Ticket id

url

  • Type: string
  • Required:

Ticket URL

Definitions

Was this page helpful?