Skip to main content
POST
Create RecurringJournalEntry record

Authorizations

X-API-KEY
string
header
required

Headers

Idempotency-Key
string

Optional. A unique value (a UUID works well) identifying this operation. If the request is repeated with the same key, the original response is replayed instead of the operation running again, so a retry cannot create a duplicate record. Results are replayable for 48 hours. Reusing a key with a different request body returns 422.

Maximum string length: 255

Query Parameters

apply_default_classifications
boolean
default:true

When false, store submitted line classifications, including an empty list. When omitted, organization defaults apply to new lines with omitted or empty classifications only when the organization setting is enabled.

Body

application/json
rrule
string<rrule>
required

Recurrence rule in iCalendar RRULE format (RFC 5545)

Required string length: 8 - 500
Pattern: ^FREQ=(DAILY|WEEKLY|MONTHLY|YEARLY)(?:;.*)?$
Examples:

"FREQ=DAILY"

"FREQ=WEEKLY;BYDAY=MO,WE,FR"

"FREQ=MONTHLY;BYMONTHDAY=15"

"FREQ=YEARLY;BYMONTH=12;BYMONTHDAY=25"

"FREQ=MONTHLY;BYDAY=1MO"

"FREQ=WEEKLY;INTERVAL=2;BYDAY=TU,TH"

"FREQ=MONTHLY;BYMONTHDAY=1;COUNT=12"

"FREQ=DAILY;UNTIL=20241231T235959Z"

"FREQ=WEEKLY;WKST=SU;BYDAY=MO,TU,WE,TH,FR"

memo
string
required
name
string
required
date
string<date>
required
company_id
integer
required
status
enum<string>
required
Available options:
active,
inactive
recurring_type
enum<string>
required
Available options:
automatic,
reminder
record_payload
PublicJournalEntrySchemaCreateIn · object
required

Response

OK

internal_id
integer
required
number
integer
required
name
string
required
memo
string
required
date
string<date>
required
company_id
integer
required
company_name
string
required
company_currency
string
required
status
enum<string>
required
Available options:
active,
inactive
record_payload
any
required
rrule
string
required
next_occurrence
string<date-time> | null
required
last_generated
string<date-time> | null
required
errors
Errors · object
required

Lists failures that stop this template from creating records. The key is the date in next_occurrence (YYYY-MM-DD) and the value is the error message.

recurring_type
enum<string>
required
Available options:
automatic,
reminder
records
PublicRecurringRecordSchemaOut · object[]
required
created_at
string<date-time>
required

Date and time the record was created

updated_at
string<date-time>
required

Date and time the record was last updated

created_by
AuditActorSchemaOut · object | null

Schema for audit actor information.

updated_by
AuditActorSchemaOut · object | null

Schema for audit actor information.

code
string | null