Create Ticket

POST /projects/{project_id}/tools/#ZENDESK_CREATE_TICKET

Create Ticket

cURL

curl --request POST \
  --url 'https://actionkit.useparagon.com/projects/{project_id}/tools/#ZENDESK_CREATE_TICKET' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tool": "ZENDESK_CREATE_TICKET",
  "parameters": {
    "ticketSubject": "<string>",
    "ticketDescription": "<string>",
    "requesterName": "<string>",
    "requesterEmail": "<string>",
    "assigneeId": "<string>",
    "ticketDueAt": "2023-12-25",
    "ticketTags": "<string>",
    "ticketExternalId": "<string>",
    "ticketCustomFields": [
      {
        "id": 123,
        "value": "<string>"
      }
    ]
  }
}
'

200

{
  "ticket": {
    "url": "https://example.zendesk.com/api/v2/tickets/35436.json",
    "id": 35436,
    "external_id": null,
    "via": {
      "channel": "api",
      "source": {
        "from": {},
        "to": {},
        "rel": null
      }
    },
    "created_at": "2026-10-16T05:54:37Z",
    "updated_at": "2026-10-16T05:54:37Z",
    "generated_timestamp": 0,
    "type": null,
    "subject": "[Paragon docs test] safe to delete",
    "raw_subject": "[Paragon docs test] safe to delete",
    "description": "Temporary ticket created while documenting ActionKit responses. Deleted right after.",
    "priority": "normal",
    "status": "open",
    "recipient": null,
    "requester_id": 360000020441,
    "submitter_id": 360000020441,
    "assignee_id": 360000040777,
    "organization_id": null,
    "group_id": 360000060358,
    "collaborator_ids": [],
    "follower_ids": [],
    "email_cc_ids": [],
    "forum_topic_id": null,
    "problem_id": null,
    "has_incidents": false,
    "is_public": true,
    "due_at": null,
    "tags": [],
    "custom_fields": [
      {
        "id": 360000080418,
        "value": null
      },
      {
        "id": 360000100193,
        "value": null
      },
      {
        "id": 360000120129,
        "value": null
      },
      {
        "id": 360000140177,
        "value": null
      },
      {
        "id": 360000160113,
        "value": null
      },
      {
        "id": 360000180609,
        "value": null
      },
      {
        "id": 360000200409,
        "value": null
      },
      {
        "id": 360000220953,
        "value": null
      },
      {
        "id": 360000240465,
        "value": null
      },
      {
        "id": 360000260201,
        "value": null
      },
      {
        "id": 360000280353,
        "value": null
      },
      {
        "id": 360000300641,
        "value": null
      },
      {
        "id": 360000320209,
        "value": null
      }
    ],
    "satisfaction_rating": {
      "score": "unoffered"
    },
    "sharing_agreement_ids": [],
    "custom_status_id": 360000340813,
    "encoded_id": "V0WRRD-5DM05",
    "fields": [
      {
        "id": 360000080418,
        "value": null
      },
      {
        "id": 360000100193,
        "value": null
      },
      {
        "id": 360000120129,
        "value": null
      },
      {
        "id": 360000140177,
        "value": null
      },
      {
        "id": 360000160113,
        "value": null
      },
      {
        "id": 360000180609,
        "value": null
      },
      {
        "id": 360000200409,
        "value": null
      },
      {
        "id": 360000220953,
        "value": null
      },
      {
        "id": 360000240465,
        "value": null
      },
      {
        "id": 360000260201,
        "value": null
      },
      {
        "id": 360000280353,
        "value": null
      },
      {
        "id": 360000300641,
        "value": null
      },
      {
        "id": 360000320209,
        "value": null
      }
    ],
    "followup_ids": [],
    "brand_id": 360000360398,
    "allow_channelback": false,
    "allow_attachments": true,
    "from_messaging_channel": false,
    "support_type": "agent"
  },
  "audit": {
    "id": 360000380729,
    "ticket_id": 35436,
    "created_at": "2026-10-16T05:54:37Z",
    "author_id": 360000040777,
    "metadata": {
      "system": {
        "client": "axios/0.24.0",
        "ip_address": "203.0.113.10",
        "transaction_id": "01M51MDM0R597S5YPXMHR46ANH",
        "location": "Example City, United States",
        "latitude": 39.0469,
        "longitude": -77.4903
      },
      "custom": {},
      "notifications_suppressed_for": [
        360000020441
      ]
    },
    "events": [
      {
        "id": 360000400857,
        "type": "Comment",
        "author_id": 360000020441,
        "body": "Temporary ticket created while documenting ActionKit responses. Deleted right after.",
        "html_body": "<div class=\"zd-comment\" dir=\"auto\"><p dir=\"auto\">Temporary ticket created while documenting ActionKit responses. Deleted right after.</p></div>",
        "plain_body": "Temporary ticket created while documenting ActionKit responses. Deleted right after.",
        "public": true,
        "attachments": [],
        "audit_id": 360000380729
      },
      {
        "id": 360000420985,
        "type": "Create",
        "value": "360000020441",
        "field_name": "requester_id"
      },
      {
        "id": 360000440113,
        "type": "Create",
        "value": "normal",
        "field_name": "priority"
      },
      {
        "id": 360000460241,
        "type": "Create",
        "value": "[Paragon docs test] safe to delete",
        "field_name": "subject"
      },
      {
        "id": 360000480369,
        "type": "Create",
        "value": null,
        "field_name": "type"
      },
      {
        "id": 360000500497,
        "type": "Create",
        "value": "open",
        "field_name": "status"
      },
      {
        "id": 360000520625,
        "type": "Create",
        "value": "360000060358",
        "field_name": "group_id"
      },
      {
        "id": 360000540753,
        "type": "Create",
        "value": "360000040777",
        "field_name": "assignee_id"
      },
      {
        "id": 360000560881,
        "type": "Create",
        "value": "360000340813",
        "field_name": "custom_status_id"
      },
      {
        "id": 360000580009,
        "type": "Create",
        "value": "360000600377",
        "field_name": "ticket_form_id"
      },
      {
        "id": 360000620137,
        "type": "Notification",
        "via": {
          "channel": "rule",
          "source": {
            "from": {
              "deleted": false,
              "title": "Notify all agents of received request",
              "id": 360000640977
            },
            "rel": "trigger"
          }
        },
        "subject": "[{{ticket.account}}] {{ticket.title}}",
        "body": "A ticket (#{{ticket.id}}) by {{ticket.requester.name}} has been received. It is unassigned.\n\n{{ticket.comments_formatted}}",
        "recipients": [
          360000040777
        ]
      }
    ],
    "via": {
      "channel": "api",
      "source": {
        "from": {},
        "to": {},
        "rel": null
      }
    }
  }
}

Provider API: Zendesk Support API (v2).

Authorizations

Authorization · string · header · required

Your Paragon User Token (JWT), which you can generate using your project's signing keys.

Path Parameters

project_id · string · required

Your Paragon Project ID. You can copy your Project ID from your dashboard URL or by clicking Copy Project ID under the Environment switcher.

Body

application/json

tool · string · default: ZENDESK_CREATE_TICKET · required

parameters · object · required

Show child attributes

Response

200 - application/json

The Zendesk Support API response for the new ticket. The ticket is wrapped in ticket, and audit describes the change Zendesk recorded. The fields depend on your Zendesk account configuration, including custom fields.