---
title: "Create a workflow rule"
method: POST
path: "/v1/issuance/tokens/{tokenId}/workflows"
tags: ["Issuance"]
---

# Create a workflow rule

`POST /v1/issuance/tokens/{tokenId}/workflows`

Creates a WHEN → THEN automation rule. The action is capability-gated at save time; an unsupported action returns 400 with a typed reason.

## Path parameters

- `tokenId` string, required — Token identifier.

## Headers

- `x-project-id` string — Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

## Request body

- CreateWorkflowRequest
  - `triggerType` string, required
  - `actionType` string, required
  - `condition` WorkflowCondition, nullable
    - `all` object[], required
      - `field` string, required
      - `op` 'eq' | 'neq' | 'in', required
      - `value` union, required
        - string
        - number
        - union[]
          - union
            - string
            - number
  - `actionParams` object
  - `reviewMode` 'auto' | 'manual'
  - `retryPolicy` object
    - `maxAttempts` integer, required
    - `retryAfterMinutes` integer, required
  - `enabled` boolean

## Response `201`

Workflow created

- WorkflowResponse
  - `data` object, required
    - `workflow` object, required
      - `id` string, required
      - `token_id` string, required
      - `trigger_type` string, required
      - `action_type` string, required
      - `enabled` boolean, required
      - `review_mode` 'auto' | 'manual', required
      - `created_at` string, required
  - `meta` object

## Other responses

- `400` — Error
- `401` — Error
- `403` — Error
- `404` — Error
- `500` — Error

---

[API](https://skmtc.net/solana/apis/solana-developer-platform-api.md) · [All operations](https://skmtc.net/solana/apis/solana-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solana/solana-developer-platform-api/revisions/672b1916ba61/schema)