Aqtos icon

Aqtos

Consume Aqtos API

Actions5

Expense → Create

AI-generated

Summary

Create a new expense record in Aqtos by sending the expense data as JSON either through structured form fields or a custom JSON body.

Inputs

  • Body Input Method - 'Form Fields' or 'Custom JSON' to choose how to provide the expense data. (required) — Controls whether to use structured fields or raw JSON for the request body.
  • If using 'Form Fields':
    - Title (string, required): The expense title.
    - Amount (number, required): The expense amount.
    - Currency Code (string, required): The currency code (e.g., USD).
    - Status (option, required): "PAID" or "UNPAID".
    - Due Date (datetime, required): The expense due date.
    - Note (string, optional): Additional expense note.
    - Expense ID (string, optional): Optional expense identifier.
    - Expense Category (option, optional): Category name or ID.
    - Recurring (boolean, required): Whether the expense is recurring.
    - If recurring is true, additional recurrence fields including frequency, interval, days, month days, week numbers.
    - Payment Date (datetime, optional): Date of payment.
    - Vendor (option, optional): Vendor name or ID.
    - Owner Account (option, optional): Owner account name or ID.
    - Correlation ID (string, optional): Correlation identifier.     (required) — Various expense fields to define the expense details.
  • If using 'Custom JSON':
    - Custom JSON Body (json, required): The raw JSON to send as the expense data.     (required) — Custom JSON body containing the entire expense payload.

Output shape

a single JSON object representing the created expense or the API response.

The action sends a POST request to the Aqtos API endpoint /submitCommand/CreateExpenseCommand with the constructed JSON body. The response is included in the node output. Errors are handled per item and can be continued on fail.

Examples

Example 1: Create Expense Using Form Fields

Set Body Input Method to 'Form Fields' and provide required expense details such as title, amount, currency code, status, due date, and optionally recurrence and vendor info.

Example 2: Create Expense Using Custom JSON

Set Body Input Method to 'Custom JSON' and provide the entire expense JSON body as a string or JSON object.

Links

Discussion