Zendesk · Arazzo Workflow

Zendesk Create and Verify Custom Ticket Field

Version 1.0.0

Create a custom ticket field, then confirm it appears in the account's field list.

1 workflow 1 source API 1 provider
View Spec View on GitHub ChatCRMHelp CenterSellSupportT1TalkTicketingTicketsArazzoWorkflows

Provider

zendesk

Workflows

create-custom-ticket-field
Create a custom ticket field and verify it in the field list.
Creates a custom ticket field and then lists ticket fields to confirm it was registered.
2 steps inputs: title, titleInPortal, type outputs: fieldId
1
createField
CreateTicketField
Create the custom ticket field.
2
verifyField
ListTicketFields
List ticket fields to confirm the new field is registered.

Source API Descriptions

Arazzo Workflow Specification

zendesk-create-custom-ticket-field-workflow.yml Raw ↑
arazzo: 1.0.1
info:
  title: Zendesk Create and Verify Custom Ticket Field
  summary: Create a custom ticket field, then confirm it appears in the account's field list.
  description: >-
    A configuration pattern for Zendesk Support. The workflow creates a custom
    ticket field of the supplied type and title, captures the new field id, and
    then lists all ticket fields to verify the field is present. The create body
    uses the documented {ticket_field:{...}} envelope and is spelled out inline.
  version: 1.0.0
sourceDescriptions:
- name: ticketFieldsApi
  url: ../openapi/ticket-fields-openapi-original.yml
  type: openapi
workflows:
- workflowId: create-custom-ticket-field
  summary: Create a custom ticket field and verify it in the field list.
  description: >-
    Creates a custom ticket field and then lists ticket fields to confirm it was
    registered.
  inputs:
    type: object
    required:
    - type
    - title
    properties:
      type:
        type: string
        description: >-
          The custom field type (text, textarea, checkbox, date, integer,
          decimal, regexp, multiselect, tagger, lookup).
      title:
        type: string
        description: The title shown to agents for the field.
      titleInPortal:
        type: string
        description: Optional title shown to end users in the help center portal.
  steps:
  - stepId: createField
    description: Create the custom ticket field.
    operationId: CreateTicketField
    requestBody:
      contentType: application/json
      payload:
        ticket_field:
          type: $inputs.type
          title: $inputs.title
          title_in_portal: $inputs.titleInPortal
    successCriteria:
    - condition: $statusCode == 201
    outputs:
      fieldId: $response.body#/ticket_field/id
  - stepId: verifyField
    description: List ticket fields to confirm the new field is registered.
    operationId: ListTicketFields
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      fields: $response.body#/ticket_fields
  outputs:
    fieldId: $steps.createField.outputs.fieldId