curl --request POST \
--url https://web.subly.app/api/v1/transactions \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"amount": 123,
"currency_code": "<string>",
"date": "2023-11-07T05:31:56Z",
"sub_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"revenue_item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"category": "<string>",
"tags": [
123
],
"website": "<string>",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://web.subly.app/api/v1/transactions"
payload = {
"amount": 123,
"currency_code": "<string>",
"date": "2023-11-07T05:31:56Z",
"sub_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"revenue_item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"category": "<string>",
"tags": [123],
"website": "<string>",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 123,
currency_code: '<string>',
date: '2023-11-07T05:31:56Z',
sub_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
revenue_item_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
name: '<string>',
category: '<string>',
tags: [123],
website: '<string>',
project_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
})
};
fetch('https://web.subly.app/api/v1/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://web.subly.app/api/v1/transactions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'amount' => 123,
'currency_code' => '<string>',
'date' => '2023-11-07T05:31:56Z',
'sub_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'revenue_item_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'name' => '<string>',
'category' => '<string>',
'tags' => [
123
],
'website' => '<string>',
'project_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://web.subly.app/api/v1/transactions"
payload := strings.NewReader("{\n \"amount\": 123,\n \"currency_code\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"sub_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"revenue_item_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"category\": \"<string>\",\n \"tags\": [\n 123\n ],\n \"website\": \"<string>\",\n \"project_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://web.subly.app/api/v1/transactions")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 123,\n \"currency_code\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"sub_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"revenue_item_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"category\": \"<string>\",\n \"tags\": [\n 123\n ],\n \"website\": \"<string>\",\n \"project_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://web.subly.app/api/v1/transactions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 123,\n \"currency_code\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"sub_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"revenue_item_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"category\": \"<string>\",\n \"tags\": [\n 123\n ],\n \"website\": \"<string>\",\n \"project_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sub_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"revenue_item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"amount": 123,
"currency_code": "<string>",
"date": "2023-11-07T05:31:56Z",
"category": "<string>",
"tags": [
123
],
"website": "<string>",
"workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>"
}{
"error": "<string>"
}Create a transaction
Creates a new transaction record. The workspace_id is automatically assigned. A transaction can be optionally linked to an existing expense or revenue item.
curl --request POST \
--url https://web.subly.app/api/v1/transactions \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"amount": 123,
"currency_code": "<string>",
"date": "2023-11-07T05:31:56Z",
"sub_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"revenue_item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"category": "<string>",
"tags": [
123
],
"website": "<string>",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://web.subly.app/api/v1/transactions"
payload = {
"amount": 123,
"currency_code": "<string>",
"date": "2023-11-07T05:31:56Z",
"sub_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"revenue_item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"category": "<string>",
"tags": [123],
"website": "<string>",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 123,
currency_code: '<string>',
date: '2023-11-07T05:31:56Z',
sub_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
revenue_item_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
name: '<string>',
category: '<string>',
tags: [123],
website: '<string>',
project_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
})
};
fetch('https://web.subly.app/api/v1/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://web.subly.app/api/v1/transactions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'amount' => 123,
'currency_code' => '<string>',
'date' => '2023-11-07T05:31:56Z',
'sub_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'revenue_item_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'name' => '<string>',
'category' => '<string>',
'tags' => [
123
],
'website' => '<string>',
'project_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://web.subly.app/api/v1/transactions"
payload := strings.NewReader("{\n \"amount\": 123,\n \"currency_code\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"sub_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"revenue_item_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"category\": \"<string>\",\n \"tags\": [\n 123\n ],\n \"website\": \"<string>\",\n \"project_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://web.subly.app/api/v1/transactions")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 123,\n \"currency_code\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"sub_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"revenue_item_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"category\": \"<string>\",\n \"tags\": [\n 123\n ],\n \"website\": \"<string>\",\n \"project_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://web.subly.app/api/v1/transactions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 123,\n \"currency_code\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"sub_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"revenue_item_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"category\": \"<string>\",\n \"tags\": [\n 123\n ],\n \"website\": \"<string>\",\n \"project_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sub_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"revenue_item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"amount": 123,
"currency_code": "<string>",
"date": "2023-11-07T05:31:56Z",
"category": "<string>",
"tags": [
123
],
"website": "<string>",
"workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "<string>"
}{
"error": "<string>"
}Authorizations
Your private API key for authentication. This key identifies your workspace for all requests.
Body
ISO 4217 currency code.
Date the transaction occurred.
expense, revenue ID of an expense to link to this transaction.
ID of a revenue item to link to this transaction.
A descriptive name for the transaction.
Response
Transaction created successfully.
Unique identifier for the transaction.
ID of the linked expense, if applicable.
ID of the linked revenue item, if applicable.
A descriptive name for the transaction.
The value of the transaction.
The ISO 4217 currency code for the transaction amount.
The date and time the transaction occurred.
The type of transaction.
expense, revenue Organizational category for the transaction.
Array of tag IDs.
Associated website, if any.
Identifier of the workspace this transaction belongs to.
Identifier of the project this transaction is assigned to.
Was this page helpful?