---
title: "Create Event Subscriptions With Actions"
method: POST
path: "/v1/events/subscriptions/actions/bulk"
tags: ["events", "public"]
---

# Create Event Subscriptions With Actions

`POST /v1/events/subscriptions/actions/bulk`

## Headers

- `API-Version` string — Pass in an API version to guarantee a consistent response format. The latest version should be used for all new API calls. Existing API calls should be updated to the latest version when possible. **Valid versions:** - Latest API version (recommended): `2025-03` - Previous API version (maintenance mode): `2025-02` If no API version header is included, the response format is considered unstable and could change without notice (not recommended).

## Request body

- CreateEventSubscriptionsWithActionsRequest
  - `events_with_actions` CreateEventSubscriptionWithActions[], required
    - `event_type` 'asset_extracted' | 'asset_uploaded' | 'transform_completed', required — An enumeration.
    - `proj_id` string — Project ID for the event subscription. Either proj_id or transform_id must be present, but not both.
    - `transform_id` string — Transformation ID for the event subscription. Either proj_id or transform_id must be present, but not both.
    - `actions` CreateEventSubscriptionAction[], required
      - `type` 'refresh_transform' | 'run_extraction' | 'send_webhook', required — An enumeration.
      - `transform_id` string — Transformation ID to run the action on. Required for `refresh_transform`. Either `proj_id` or `transform_id` must be present, but not both.
      - `proj_id` string — Project ID to run the action on. Required for `run_extraction` and `send_webhook`. Either `proj_id` or `transform_id` must be present, but not both.
      - `webhook_id` string — Webhook ID to call. Only used when `send_webhook` is set as `type`

## Response `200`

Successful Response

- CreateEventSubscriptionsWithActionsResponse
  - `message` string, required
  - `data` CreatedEventSubscriptionWithActionsResponse[], required
    - `event_subscription_id` string, required
    - `action_ids` string[], required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `408` — Request Timeout
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/runtrellis/apis/trellis.md) · [All operations](https://skmtc.dev/runtrellis/apis/trellis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runtrellis/trellis/revisions/b7d8570ff3cc/schema)