---
title: "Create Approval Workflow Instance"
method: POST
path: "/api/v2/approval_workflow_instances"
tags: ["Approval Workflow Instances"]
---

# Create Approval Workflow Instance

`POST /api/v2/approval_workflow_instances`

Creates an approval workflow instance attached to a ticket. The request must include a name for the workflow and a ticket id to associate with the workflow instance.

#### Allowed For

* Agents

## Response `201`

Created response

- ApprovalWorkflowInstanceObject
  - `custom_object_record` CustomObjectRecord
    - `created_at` string, date-time — The time the object was created
    - `created_by_user_id` string — Id of a user who created the object
    - `custom_object_fields` object
    - `custom_object_key` string — A user-defined unique identifier
    - `external_id` string, nullable — An id you can use to link custom object records to external data
    - `id` string — Automatically assigned upon creation
    - `name` string, required — User-defined display name for the object. If autonumbering is selected for the custom object's name field, the name isn't allowed because it's automatically generated. If uniqueness is enabled, the name must be unique.
    - `photo` object, nullable — The record photo represented as an [Attachment](/api-reference/ticketing/tickets/ticket-attachments/). The `allows_photos` property must be set to `true` for the object
    - `updated_at` string, date-time — The time of the last update of the object
    - `updated_by_user_id` string — Id of the last user who updated the object
    - `url` string — Direct link to the specific custom object

---

[API](https://skmtc.dev/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.dev/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/botbrains-io/support-api/revisions/d53eac07ba68/schema)