---
title: "Creates a temporary Kafka audit consumer that forwards audit data to a specified URL."
method: POST
path: "/api/v1/sandbox/audit-consumers"
tags: ["Sandbox"]
---

# Creates a temporary Kafka audit consumer that forwards audit data to a specified URL.

`POST /api/v1/sandbox/audit-consumers`

## Request

- Base URL: `https://q2developer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://q2developer.com/api/v1/sandbox/audit-consumers`
- Auth: OAuth 2
  - Client credentials
  - Password
  - Token URL: `/oauth2/token`

Sample request:
            
   POST /api/v1.0/sandbox/audit-consumers
   {
     "stackName": "mystack",
     "callbackUrl": "https://example.com/webhook",
     "actionFilter": "AddFundsTransfer,AddMultiWireDomestic,...",
     "ttlMinutes": 60
   }

## Request body

- CreateAuditConsumerRequest: Request model for creating a temporary Kafka audit consumer.
  - `stackName` string, required: The stack name to consume audit data from.
  - `callbackUrl` string, uri, required: The callback URL where audit data will be sent.
  - `actionFilter` string, nullable: Comma-separated list of audit actions to filter (empty string for all actions). Example: "CREATE,UPDATE,DELETE"
  - `ttlMinutes` integer, required: Time-to-live in minutes for the temporary consumer. Minimum 5 minutes, maximum 1440 (24 hours).

## Response `200`

OK

- AuditConsumerInfo
  - `consumerId` string, nullable
  - `stackName` string, nullable
  - `callbackUrl` string, nullable
  - `createdAt` string, date-time
  - `expiresAt` string, date-time
  - `status` string, nullable

## Changes

- **2026-11-04** `78be088e46ef`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/q2developer/apis/q2-portal-web-server/changes/api/v1/sandbox/audit-consumers/post.md)

---

[API](https://skmtc.dev/q2developer/apis/q2-portal-web-server.md) - [All operations](https://skmtc.dev/q2developer/apis/q2-portal-web-server/llms.txt) - [OpenAPI document](https://skmtc.dev/q2developer/apis/q2-portal-web-server/revisions/78be088e46ef?raw)