Overview
The OSTicket node for n8n allows you to interact with the OSTicket helpdesk system. Specifically, the Ticket → Create operation enables users to create new support tickets programmatically. This is useful for automating ticket creation from web forms, monitoring systems, or integrating customer requests from other platforms directly into your OSTicket instance.
Practical examples:
- Automatically open a support ticket when a critical server alert is triggered.
- Create tickets from contact form submissions on your website.
- Integrate third-party services (e.g., CRM, chatbots) to log issues in OSTicket.
Properties
| Name | Type | Meaning |
|---|---|---|
| String | The email address of the person creating the ticket. | |
| Name | String | The name of the person creating the ticket. |
| Subject | String | The subject line for the ticket. |
| Message | String | The main content or body of the ticket. |
| Additional Fields | Collection | Optional extra fields to customize ticket creation. Includes: |
| — Alert | Boolean | Whether to disable alerts to staff (true = alerts enabled, false = disabled). |
| — Autorespond | Boolean | Whether to disable autorespond (true = autorespond enabled, false = disabled). |
| — Priority ID | Options | The priority level for the ticket: Low (1), Normal (2), High (3), Emergency (4). |
Output
The node returns a json object representing the newly created ticket. The structure typically includes:
- Ticket ID
- Status
- Subject
- Requester details (name, email)
- Message content
- Priority
- Any additional metadata returned by the OSTicket API
Note: The exact output fields depend on the OSTicket API response and may include more details.
Dependencies
- External Service: Requires access to an OSTicket instance with API enabled.
- API Key: You must configure valid OSTicket API credentials (
osTicketApi) in n8n. - Environment Variables: None required by default, but the OSTicket domain and self-signed certificate settings are used from credentials.
Troubleshooting
Common Issues:
- Invalid Credentials: If the API key or domain is incorrect, authentication will fail. Double-check your credentials.
- Missing Required Fields: All required fields (Email, Name, Subject, Message) must be provided; otherwise, the node will throw validation errors.
- Network/SSL Errors: If using self-signed certificates, ensure the "Skip SSL Certificate Validation" option matches your setup.
- OSTicket API Limitations: Some OSTicket setups may restrict API usage or have IP whitelisting—ensure your n8n instance can reach the OSTicket API.
Error Messages:
- 401 Unauthorized: Check your API key and permissions.
- 400 Bad Request: Ensure all required fields are filled and data types are correct.
- Connection Refused: Verify the OSTicket domain and network connectivity.