Finance/YNAB API Endpoints

Create a single transaction or multiple transactions

v1.0.0

Creates a single transaction or multiple transactions. If you provide a body containing a transaction object, a single transaction will be created and if you provide a body containing a transactions array, multiple transactions will be created. Scheduled transactions cannot be created on this endpoint.

Input

{
  "type": "object",
  "properties": {
    "budget_id": {
      "type": "string"
    },
    "transaction": {
      "type": "object"
    },
    "transactions": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  },
  "required": [
    "budget_id"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "server_knowledge",
        "transaction_ids"
      ],
      "properties": {
        "duplicate_import_ids": {
          "type": "array",
          "description": "If multiple transactions were specified, a list of import_ids that were not created because of an existing `import_id` found on the same account",
          "items": {
            "type": "string"
          }
        },
        "server_knowledge": {
          "type": "integer",
          "format": "int64",
          "description": "The knowledge of the server"
        },
        "transaction": {
          "type": "object"
        },
        "transaction_ids": {
          "type": "array",
          "description": "The transaction ids that were saved",
          "items": {
            "type": "string"
          }
        },
        "transactions": {
          "type": "array",
          "description": "If multiple transactions were specified, the transactions that were saved",
          "items": {
            "type": "object"
          }
        }
      }
    }
  }
}