Zammad icon

Zammad

Consume Zammad REST API

Actions57

State → Create

AI-generated

Overview

This node operation creates a new state in the Zammad ticketing system using the REST API. It is useful for automating the management of ticket states, such as defining new workflow states for tickets. For example, a user can create a state named 'In Review' with a specific state type ID and optional attributes like whether the state is active or if escalation should be ignored.

Use Case Examples

  1. Create a new ticket state named 'In Progress' with a state type ID of 3 and mark it as active.
  2. Create a default follow-up state with a note explaining its purpose.

Properties

Name Meaning
Authentication The authentication method to use for the API request (Basic, OAuth2, or Token Authentication).
API The API to use, either REST API or CTI API.
Name The name of the state to create.
State Type ID The state type ID of the state to create.
Additional Fields Optional additional fields for the state, such as next state ID, ignore escalation flag, active flag, default create flag, default follow-up flag, and a note.

Output

JSON

  • id - The unique identifier of the created state.
  • name - The name of the created state.
  • state_type_id - The type ID of the created state.
  • next_state_id - The ID of the next state, if specified.
  • ignore_escalation - Flag indicating if escalation is ignored.
  • active - Flag indicating if the state is active.
  • default_create - Flag indicating if the state is default for creation.
  • default_follow_up - Flag indicating if the state is default for follow-up.
  • note - Additional note about the state.

Dependencies

  • Zammad REST API

Troubleshooting

  • Ensure that the authentication credentials are correctly configured and valid for the chosen authentication method.
  • Verify that the 'name' and 'state_type_id' fields are provided and valid, as they are required for creating a state.
  • Check API endpoint availability and network connectivity to the Zammad server.
  • If the API returns an error, review the error message for details such as permission issues or invalid parameters.

Links

Discussion