Skip to main content
Sevdesk logo
  • Category: accounting
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 131
  • Triggers: 0
  • Slug: SEVDESK
  • Version: 20261101_00

Tools

Slug: SEVDESK_BOOK_INVOICE_AMOUNTTool to book an invoice amount in SevDesk. Use when you need to record a payment for an invoice, either full or partial. This creates an invoice log entry and updates the invoice status accordingly.

Input Parameters

integer
required
The booking date as Unix timestamp. Most likely the current date
string ("FULL_PAYMENT" | "N" | "CB" | "CF" | "O" | "OF" | "MTC")
required
Define a type for the booking. FULL_PAYMENT = Normal booking, N = Partial booking (historically used for normal booking), CB = Reduced amount due to discount (skonto), CF = Reduced/Higher amount due to currency fluctuations (deprecated), O = Reduced/Higher amount due to other reasons, OF = Higher amount due to reminder charges, MTC = Reduced amount due to the monetary traffic costs
number
required
Amount which should be booked. Can also be a partial amount
integer
required
ID of invoice to book
boolean
Determines if a feed is created for the booking process
object
required
The check account on which should be booked
object
Reference to a check account transaction.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_BOOK_VOUCHER_AMOUNTRecord a full or partial payment against a sevDesk voucher.

Input Parameters

string
required
Booking date in date-time format
number
required
Full or partial amount to book
integer
required
ID of the voucher to book
boolean
Whether to create a feed entry for the booking
string ("FULL_PAYMENT" | "N" | "CB" | "O" | "OF" | "MTC")
required
Booking reason: FULL_PAYMENT for full payment, N for partial payment, CB for a discount, O for another adjustment, OF for reminder charges, or MTC for transaction costs
object
required
Check account on which to book
object
Transaction required for online accounts and omitted for other account types.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CANCEL_INVOICECancel an invoice and return the automatically paid cancellation invoice.

Input Parameters

integer
required
ID of the invoice to cancel

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CHECK_CUSTOMER_NUMBER_AVAILABILITYTool to check if a customer number is available in sevDesk. Use when you need to verify that a customer number can be assigned without conflicts.

Input Parameters

string
The customer number to be checked. If not provided, checks general availability.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CREATE_ACCOUNTING_CONTACTTool to create a new accounting contact in sevDesk. Use when you need to assign debitor or creditor numbers to existing contacts for accounting purposes.

Input Parameters

object
required
The contact to which this accounting contact belongs
integer
Debitor number of the accounting contact. Used for customer/receivable accounting.
integer
Creditor number of the accounting contact. Used for supplier/payable accounting.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CREATE_CHECK_ACCOUNT_TRANSACTIONTool to create a new check account transaction in SevDesk. Use when you need to manually record a transaction for a payment account, such as bank transfers, cash movements, or other financial transactions that need to be tracked in the accounting system.

Input Parameters

number
required
Amount of the transaction (use positive for income, negative for expense)
string ("created" | "linked" | "private" | "booked")
required
Status of the check account transaction: created (100), linked (200), private (300), or booked (400)
string
Date the check account transaction was imported, in ISO 8601 format (e.g., ‘2024-05-10T00:00:00+02:00’)
string
required
Date the check account transaction was booked, in ISO 8601 format (e.g., ‘2024-05-10T00:00:00+02:00’)
object
required
The check account to which the transaction belongs
string
The purpose of the transaction
string
required
Name of the other party involved in the transaction
string
IBAN or account number of the other party
object
Reference to the source transaction for rebooking.
object
Reference to the target transaction for rebooking.
string
BIC or bank code of the other party

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CREATE_CLEARING_ACCOUNTTool to create a new clearing account in sevDesk. Use when you need to set up accounts for tracking intermediate transactions like coupons, gift cards, or prepayments. Clearing accounts are offline accounts used for booking purposes.

Input Parameters

string
required
Name of the clearing account
integer
The booking account used for this clearing account, e.g. 3320 in SKR04 and 1723 in SKR03. Must be unique among all your CheckAccounts. Ask your tax consultant what to choose.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CREATE_COMMUNICATION_WAYTool to create a new contact communication way (email, phone, website, etc.) in SevDesk. Use when you need to add contact information like email addresses, phone numbers, or website URLs to an existing contact.

Input Parameters

object
required
The key/category of the communication way. For all available keys, use GET /CommunicationWayKey endpoint
boolean
Defines whether this is the main communication way for the contact. Only one communication way of each type can be marked as main
string ("EMAIL" | "PHONE" | "WEB" | "MOBILE")
required
Type of the communication way
string
required
The value of the communication way (e.g., phone number, email address, or website URL)
object
Reference to a contact in SevDesk

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CREATE_CONTACTCreates a new contact (person or company) in SevDesk accounting system. Required fields: - type: Must be ‘PERSON’ or ‘COMPANY’ - familyname: Required for PERSON type (last name) - name: Required for COMPANY type (company name) - category: Contact category reference (e.g., id=3 for Customer, id=2 for Supplier) Automatically generates customerNumber if not provided. Supports optional fields like email, phone, address, bank details, tax information, and more.

Input Parameters

string
Fax number
string
Company name, required if type=COMPANY
string ("PERSON" | "COMPANY")
required
Contact type: PERSON or COMPANY
string
Email address
string
Telephone number
string ("m" | "w" | "d")
Gender: m=male, w=female, d=diverse
string
Mobile phone number
object
Postal address for the contact
number
Annual revenue as numeric value
string
Birth date in YYYY-MM-DD format
object
required
Category reference for grouping contacts. Common values: id=3 for ‘Customer’, id=2 for ‘Supplier’
string
Deprecated: Use ‘familyname’ instead. This field is kept for backward compatibility.
string
First name of the person
string
Tax number
string
Tax office
string
VAT number
string
Last name/family name, required if type=PERSON
object
Bank account details for the contact
string
Free-text notes
string
Academic title (e.g., Dr.)
string
Customer reference code

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CREATE_CONTACT2Tool to create a new contact in sevDesk using the standard REST API endpoint. Use when you need to create a person or organization contact with category assignment.

Input Parameters

string
The organization name. Be aware that the type of contact will depend on this attribute. If it holds a value, the contact will be regarded as an organization.
string
Second name of the contact. Not to be used for organizations.
string
A non-academic title for the contact. Not to be used for organizations.
string
Gender of the contact. Not to be used for organizations.
object
Parent contact reference - must be an organization
integer
Defines the status of the contact. 100 = Lead, 500 = Pending, 1000 = Active. Defaults to 100.
string
Birthday of the contact in YYYY-MM-DD format. Not to be used for organizations.
object
required
Category of the contact. Required field. For more information, see https://my.sevdesk.de/apiOverview/index.html#/doc-contacts#types
string
The first name of the contact. Not to be used for organizations.
boolean
Defines if the contact is freed from paying VAT.
string
The tax number of the contact.
string
The tax office of the contact (only for greek customers).
string
VAT number of the contact.
string
Bank number of the bank used by the contact.
string
The last name of the contact. Not to be used for organizations.
string
Bank account number (IBAN) of the contact.
string
A description for the contact.
string
An academic title for the contact. Not to be used for organizations.
string
Buyer reference of the contact.
string
The customer number
integer
The payment goal in days which is set for every invoice of the contact.
boolean
Defines whether the contact is a government agency (true) or not (false).
integer
Absolute time in days which the contact has to pay his invoices and subsequently get a cashback.
number
The default discount the contact gets for every invoice. Depending on defaultDiscountPercentage attribute, in percent or absolute value.
number
Percentage of the invoice sum the contact gets back if he paid invoices in time.
boolean
Defines if the discount is a percentage (true) or an absolute value (false).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CREATE_CONTACT_ADDRESSTool to create a new contact address in SevDesk. Use when you need to add a new address for an existing contact with street, city, postal code, and country information.

Input Parameters

string
Zip code
string
City name
string
Name in address
string
Second name in address
string
Third name in address
string
Fourth name in address
string
Street name
object
required
The contact to which this contact address belongs
object
required
Country of the contact address. For all countries, send a GET to /StaticCountry
object
required
Category of the contact address. For all categories, send a GET to /Category?objectType=ContactAddress

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CREATE_CONTACT_CUSTOM_FIELDTool to create a custom field for a contact in sevDesk. Use when you need to add custom field values to a contact. Requires references to both the contact and the custom field setting that defines the field type.

Input Parameters

string
required
The value to set for this custom field
object
required
Reference to the contact for which to create the custom field
object
required
Reference to the custom field setting that defines the field type and metadata

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CREATE_CONTACT_CUSTOM_FIELD_SETTINGCreates a new contact custom field setting in sevDesk for tracking additional contact information. Use this tool when you need to add custom fields to contacts to store information beyond the standard fields provided by sevDesk (e.g., customer type, lead source, industry classification, or other custom attributes). Once created, these custom fields can be used when managing contacts.

Input Parameters

string
required
Name of the contact custom field (e.g., ‘Customer ID’, ‘Referral Source’, ‘Industry’)
string
Internal object name which should be ‘ContactCustomFieldSetting’. This is typically set automatically by the API.
string
Description of the contact custom field to explain its purpose or usage

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CREATE_CREDIT_NOTE_FROM_INVOICETool to create a new credit note from an existing invoice in SevDesk. Use when you need to issue a credit note based on an already created invoice.

Input Parameters

object
required
Reference to the existing invoice to create a credit note from

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CREATE_FILE_IMPORT_ACCOUNTTool to create a new file import account (check account) in sevDesk. Use when you need to set up a new bank account that will receive transaction imports via CSV or MT940 files. The account will be created with type ‘online’ to support file imports.

Input Parameters

string
IBAN of the bank account, without spaces
string
required
Name of the check account
string ("CSV" | "MT940")
required
Import type for transactions. CSV for comma-separated values or MT940 for the MT940 format
integer
The booking account used for this bank account, e.g. 1800 in SKR04 and 1200 in SKR03. Must be unique among all your CheckAccounts. If not provided, a sensible default will be used

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CREATE_PARTTool to create a new part (product or service) in SevDesk. Use when you need to add inventory items, products, or services to the system for use in invoices and orders.

Input Parameters

string
required
Name of the part
string
A text describing the part - longer description or notes
number
Net price for which the part is sold. Deprecated - use priceNet instead. This parameter will be changed so that the gross price is calculated automatically
number
required
The stock quantity of the part
object
required
The unit in which the part is measured (e.g., pieces, hours, meters)
string ("inactive" | "active")
Status of the part in sevDesk
number
required
Tax rate of the part as a percentage (e.g., 19 for 19% VAT)
object
Category reference for a part
number
Net price for which the part is sold (excluding tax)
string
required
The part number - unique identifier for the part
number
Gross price for which the part is sold (including tax)
boolean
required
Whether stock tracking is enabled for this part. Set to true to track inventory, false to disable
number
Purchase price of the part (cost)
string
An internal comment for the part. Does not appear on invoices and orders

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CREATE_PAYMENT_METHODCreates a new payment method in sevDesk for tracking different payment types. Use this tool when you need to add custom payment options (e.g., specific credit cards, digital wallets, or regional payment methods) that aren’t already available in the system. The created payment method can then be used when creating invoices or recording payments.

Input Parameters

string
required
Name of the payment method (e.g., ‘Credit Card’, ‘PayPal’, ‘Cash’)
string
required
Type identifier for the payment method. Common values include: ‘cash’, ‘banktransfer’, ‘creditcard’, ‘debitcard’, ‘paypal’, ‘directdebit’, ‘check’, or custom types
boolean
Whether the payment method is active and available for use. Defaults to true if omitted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CREATE_PRIVATE_TRANSACTION_RULETool to create a new private transaction rule in SevDesk. Use when you need to define rules that automatically mark transactions as private based on counterpart name or payment purpose. This is useful for separating personal transactions from business ones.

Input Parameters

string
The object name, must be ‘PrivateTransactionRule’
string
The purpose of transactions that you want to match. Transactions matching this payment purpose will be automatically marked as private.
string
The counterpart name of transactions that you want to match. Transactions matching this name will be automatically marked as private.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_CREATE_TAGTool to create a new tag and attach it to an object (Invoice, Order, Voucher, or CreditNote) in sevDesk. Use when you need to categorize or label objects for organization and filtering. If a tag with the same name already exists, it will be linked to the object instead of creating a duplicate.

Input Parameters

string
required
Name of the tag to create. If the tag already exists, it will be linked to the object instead of creating a duplicate.
object
required
Reference to the object (Invoice, Order, Voucher, or CreditNote) that should be tagged

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_DELETE_ACCOUNTING_CONTACT_BY_IDPermanently deletes an accounting contact from sevDesk by its unique identifier. This action removes the accounting contact and cannot be undone. Use this when you need to: - Remove outdated or duplicate accounting contacts - Clean up test data - Delete accounting contacts that are no longer needed The accounting contact ID must be valid and the contact must exist, otherwise a 404 error will be raised. Example: “Delete accounting contact with ID 90804710”

Input Parameters

integer
required
The unique identifier of the accounting contact to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_DELETE_CHECK_ACCOUNT_BY_IDPermanently deletes a check account from sevDesk by its unique identifier. This action removes the check account (bank account) and cannot be undone. Use this when you need to: - Remove outdated or unused bank accounts - Clean up test data - Delete check accounts that are no longer needed The check account ID must be valid and the account must exist, otherwise a 404 error will be raised. Example: “Delete check account with ID 6158594”

Input Parameters

integer
required
The unique identifier of the check account to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_DELETE_CHECK_ACCOUNT_TRANSACTION_BY_IDPermanently deletes a check account transaction from sevDesk by its unique identifier. Use when you need to remove a transaction that was created in error or is no longer needed.

Input Parameters

integer
required
Id of check account transaction to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_DELETE_COMMUNICATION_WAY_BY_IDPermanently deletes a communication way from sevDesk by its unique identifier. Use when you need to remove phone numbers, email addresses, or other contact methods from contacts. The communication way ID must be valid and exist, otherwise a 404 error will be raised.

Input Parameters

integer
required
Id of communication way resource to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_DELETE_CONTACTPermanently deletes a contact from sevDesk by its unique identifier. This action removes the contact and cannot be undone. Use this when you need to: - Remove outdated or duplicate contacts - Clean up test data - Delete contacts that are no longer needed The contact ID must be valid and the contact must exist, otherwise a 404 error will be raised. Example: “Delete contact with ID 12345”

Input Parameters

integer
required
The unique identifier of the contact to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_DELETE_CONTACT_ADDRESS_BY_IDTool to delete a contact address from sevDesk by its unique identifier. Use when you need to permanently remove a contact address that is no longer needed or is outdated.

Input Parameters

integer
required
Id of contact address resource to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_DELETE_CONTACT_CUSTOM_FIELD_BY_IDTool to permanently delete a contact custom field by its ID. Use when you need to remove a custom field value from a contact.

Input Parameters

integer
required
The unique identifier of the contact custom field to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_DELETE_CONTACT_CUSTOM_FIELD_SETTING_BY_IDTool to permanently delete a contact custom field setting by its ID. Use when you need to remove a custom field configuration from contacts.

Input Parameters

integer
required
The unique identifier of the contact custom field setting to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_DELETE_CREDIT_NOTE_BY_IDPermanently deletes a credit note from sevDesk by its unique identifier. This action removes the credit note and cannot be undone. Use this when you need to: - Remove outdated or incorrect credit notes - Clean up draft credit notes that are no longer needed - Delete test data Note: The credit note must be in draft status to be deleted. Attempting to delete a non-draft credit note will result in a 409 Conflict error. The credit note ID must be valid and exist, otherwise a 404 error will be raised. Example: “Delete credit note with ID 2569269”

Input Parameters

integer
required
The unique identifier of the credit note to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_DELETE_ORDER_BY_IDPermanently deletes an order from sevDesk by its unique identifier. Use this when you need to remove orders from the system. Note that only draft orders can be deleted - attempting to delete orders in other states will result in a 409 conflict error.

Input Parameters

integer
required
The unique identifier of the order to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_DELETE_ORDER_POS_BY_IDPermanently deletes an order position from sevDesk by its unique identifier. Use this when you need to remove line items or positions from orders. Note that deletion may fail with a 409 conflict error if the order is not in draft status.

Input Parameters

integer
required
Id of order position resource to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_DELETE_PAYMENT_METHODDeletes a payment method in sevDesk by its ID. Use this when you need to permanently remove a payment method from the system. Requires the payment method ID which can be obtained from the Get Payment Methods or Create Payment Method actions.

Input Parameters

string
required
Unique ID of the payment method to delete (numeric string)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_DELETE_PRIVATE_TRANSACTION_RULE_BY_IDPermanently deletes a private transaction rule from sevDesk by its unique identifier. Use when you need to remove a rule that is no longer needed.

Input Parameters

integer
required
Id of the rule to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_DELETE_TAG_BY_IDDelete a sevDesk tag by its unique identifier. A 404 response from sevDesk is reported as an error.

Input Parameters

integer
required
Id of tag to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_DOWNLOAD_INVOICE_PDFDownload one invoice PDF with explicit control over sevDesk’s sent-state behavior.

Input Parameters

boolean
Choose sevDesk’s documented download response mode when explicitly set
integer
required
ID of the invoice whose PDF to download
boolean
Set true to prevent sevDesk from marking the invoice as sent during PDF retrieval; false or omission allows the provider’s default behavior

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_ENSHRINE_CHECK_ACCOUNT_TRANSACTIONTool to enshrine a check account transaction by its ID. Use when you need to permanently lock or finalize a transaction to prevent further modifications.

Input Parameters

integer
required
The unique identifier of the check account transaction to enshrine

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_EXPORT_CREDIT_NOTE_CSVTool to export credit notes as CSV from SevDesk. Use when you need to retrieve credit note data in CSV format for reporting or data analysis. The export returns CSV content (either base64-encoded or plain text) along with file metadata.

Input Parameters

boolean
Specifies if the document should be downloaded. Set to true to trigger download, false to return base64-encoded content
string
Model name to be exported, should be ‘CreditNote’ for this endpoint
string
SevQuery object name, typically ‘SevQuery’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_FETCH_DICTIONARY_ENTRIES_BY_TYPETool to retrieve placeholders (dictionary entries) for a specific object type in sevDesk. Use when you need to get available template placeholders for documents like invoices, emails, or letters.

Input Parameters

string ("Invoice" | "CreditNote" | "Order" | "Contact" | "Letter" | "Email")
required
Model name to retrieve placeholders for (e.g., Invoice, Contact, Email)
string ("Invoice" | "CreditNote" | "Order" | "Contact" | "Letter")
Valid sub-object types when objectName is Email.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_FIND_CONTACTS_BY_CUSTOM_FIELD_VALUETool to find contacts by custom field value. Use when you need to search for contacts that have a specific value in a custom field.

Input Parameters

string
required
The value to be checked in the custom field
string
The ContactCustomFieldSetting name, if no ContactCustomFieldSetting ID is provided. Use this or customFieldSetting_id, not both.
string
ID of ContactCustomFieldSetting for which the value has to be checked. Use with customFieldSetting_objectName.
string
Object name. Only needed if you also defined the ID of a ContactCustomFieldSetting. Must be ‘ContactCustomFieldSetting’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GENERATE_PROGRESS_DOWNLOAD_HASHTool to generate a download hash for an export job progress. Use when you need to retrieve the progress status and download hash for an export job initiated through sevDesk’s Export API.

Input Parameters

string
required
The export job ID to generate a download hash for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_ACCOUNTING_CONTACT_BY_IDTool to retrieve accounting contact details by ID. Use when you need accounting information (debitor/creditor numbers) for a specific contact.

Input Parameters

integer
required
ID of accounting contact to return

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_ACCOUNTING_CONTACTSTool to retrieve accounting contacts from sevDesk. Use when you need to fetch accounting contact information including debitor and creditor numbers.

Input Parameters

string
ID of contact for which you want the accounting contact
string
Object name. Only needed if you also defined the ID of a contact

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_ACCOUNT_INVOICESRetrieve sevDesk account invoices for the authenticated client. The response contains an objects field holding a list of invoice objects or null.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CHECK_ACCOUNT_BALANCE_AT_DATEGet a check account’s historical balance at a specified date, considering transactions through 23:59:59. When no balance data is returned, the tool returns a balance of “0”.

Input Parameters

string
required
Date for which to calculate the balance (YYYY-MM-DD format). Only considers transactions up to this date at 23:59:59
integer
required
ID of the check account to retrieve the balance for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CHECK_ACCOUNT_BY_IDTool to retrieve details of a specific check account by ID. Use when you have a check account’s ID and need its detailed information including balance, IBAN, currency, and status.

Input Parameters

integer
required
The unique ID of the check account to retrieve from sevDesk

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CHECK_ACCOUNTSTool to retrieve a list of all check accounts. Use when you need to view or select available bank accounts in sevDesk.

Input Parameters

string
Comma-separated list of related objects to embed in the response (e.g., ‘sevClient’ to include full client details)
integer
Maximum number of results to return
integer
Number of items to skip for pagination

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CHECK_ACCOUNT_TRANSACTION_BY_IDTool to retrieve a specific check account transaction by its ID. Use when you need detailed information about a specific transaction.

Input Parameters

integer
required
ID of check account transaction to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CHECK_ACCOUNT_TRANSACTION_LOGRetrieve status and booking history for a check-account transaction.

Input Parameters

array
Related resources to embed in log entries
integer
required
ID of the check-account transaction whose log to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CHECK_ACCOUNT_TRANSACTIONSTool to retrieve list of check account transactions. Use when you need to fetch transactions with optional filters (e.g., account ID, date, status) after verifying the check account exists.

Input Parameters

string
Comma-separated list of related objects to embed, e.g., ‘checkAccount’
integer
Maximum number of transactions to return (must be >=1)
string
Filter by transaction amount
integer
Number of transactions to skip for pagination (must be >=0)
string ("OPEN" | "ASSIGNED" | "DELETED")
Filter by transaction status
string ("IN" | "OUT")
Filter by transaction direction: IN or OUT
string
Filter by voucher date (YYYY-MM-DD)
string
UUID of the check account to filter transactions by

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_COMMUNICATIONWAY_BY_IDTool to retrieve details of a specific communication way by ID. Use when you have a communication way’s ID and need its detailed information.

Input Parameters

integer
required
ID of communication way to return

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_COMMUNICATION_WAY_KEYSRetrieve a list of communication way keys from sevDesk. Communication way keys define the available types for contact communication methods (e.g., ID 1: Private, ID 2: Work, ID 3: Fax, ID 4: Mobile, ID 5: Empty, ID 6: Autobox, ID 7: Newsletter, ID 8: Invoicing). Use this to get the valid key IDs and names for creating or updating communication ways.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_COMMUNICATION_WAYSTool to retrieve communication ways from sevDesk. Use when you need to fetch contact information like phone numbers, emails, or web addresses for a contact.

Input Parameters

string ("0" | "1")
Filter for main communication way
string ("PHONE" | "EMAIL" | "WEB" | "MOBILE")
Communication way types supported by sevDesk
string
ID of contact for which you want the communication ways
string
Object name. Only needed if you also defined the ID of a contact

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CONTACT_ADDRESS_BY_IDTool to retrieve details of a specific contact address by ID. Use when you have a contact address ID and need its detailed information.

Input Parameters

integer
required
ID of contact address to return

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CONTACT_ADDRESSESTool to retrieve contact addresses from sevdesk. Use when you need to fetch address information for contacts with optional pagination and embedded related objects.

Input Parameters

string
Comma-separated list of related objects to embed in the response (e.g., ‘contact,country’)
integer
Maximum number of contact addresses to return. Default is 100
integer
Number of contact addresses to skip before returning results. Default is 0

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CONTACT_BY_IDTool to retrieve details of a specific contact by ID. Use when you have a contact’s UUID and need its detailed information.

Input Parameters

string
required
The unique ID of the contact to retrieve from sevDesk

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CONTACT_CUSTOM_FIELD_BY_IDTool to retrieve a contact custom field by its ID. Use when you need to fetch details about a specific custom field associated with a contact.

Input Parameters

integer
required
The unique identifier of the contact custom field to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CONTACT_CUSTOM_FIELDSTool to retrieve contact custom fields from sevDesk. Contact custom fields store additional user-defined information about contacts beyond standard fields. Use this when you need to fetch custom field values for contacts or list all custom field data.

Input Parameters

string
Comma-separated list of related object keys to include in the response (e.g., ‘contact,contactCustomFieldSetting’ to get additional information about the contact and field settings).
integer
Maximum number of contact custom fields to return in the response. Use this for pagination to control result size.
integer
Number of contact custom fields to skip before returning results. Use with ‘limit’ for pagination (e.g., offset=10 with limit=10 gets items 11-20).
integer
If set to 1, returns the total number of contact custom field entries matching the query in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CONTACT_CUSTOM_FIELD_SETTING_BY_IDTool to retrieve details of a specific contact custom field setting by ID. Use when you need information about a contact custom field configuration.

Input Parameters

integer
required
The unique ID of the contact custom field setting to retrieve from sevDesk

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CONTACT_CUSTOM_FIELD_SETTING_REFERENCE_COUNTTool to receive the count of references for a contact custom field setting. Use when you need to check how many times a contact custom field is referenced before deleting it.

Input Parameters

integer
required
ID of contact custom field setting to get the reference count for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CONTACT_CUSTOM_FIELD_SETTINGSTool to retrieve contact custom field settings from sevDesk. Contact custom field settings define the structure and configuration of custom fields that can be added to contacts. Use this when you need to fetch the list of available custom field configurations or understand what custom fields are defined for contacts.

Input Parameters

string
Comma-separated list of related object keys to include in the response (e.g., ‘sevClient’ to get additional information about the client).
integer
Maximum number of contact custom field settings to return in the response. Use this for pagination to control result size.
integer
Number of contact custom field settings to skip before returning results. Use with ‘limit’ for pagination (e.g., offset=10 with limit=10 gets items 11-20).
integer
If set to 1, returns the total number of contact custom field setting entries matching the query in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CONTACTSTool to retrieve a list of contacts. Use when you need to fetch contacts from sevdesk with optional filters.

Input Parameters

string
Filter by a single tag identifier
string
Filter by contact type (e.g., PERSON or COMPANY)
string
Embed related objects (comma-separated keys), e.g., ‘addresses,bankAccounts’
array
Name(s) of custom filter field(s) – each entry must have a matching value
integer
Maximum number of contacts to return
string
Sort order for results, e.g., ‘asc’ or ‘desc’
array
Value(s) for each field filter – same length as field
integer
Number of contacts to skip before returning results
Free-text search across contact fields
integer
Filter by status code
string
Filter by category identifier
string
Filter by exact customer number

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CONTACT_TABS_ITEM_COUNTTool to get the count of items across all tabs for a specific contact. Use when you need to retrieve statistics about documents, invoices, orders, and other items related to a contact.

Input Parameters

integer
required
ID of contact to return tab item counts for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CREDIT_NOTE_POSITIONSTool to retrieve credit note positions from SevDesk. Use when you need to fetch line items or positions associated with credit notes.

Input Parameters

integer
Retrieve all creditNote positions belonging to this creditNote. Must be provided with creditNote[objectName]
string
Only required if creditNote[id] was provided. ‘CreditNote’ should be used as value.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_CREDIT_NOTESTool to retrieve a list of credit notes. Use when you need to fetch multiple or filtered credit note records after confirming filters.

Input Parameters

string
Filter by specific credit note ID (numeric)
string
Comma-separated list of related entities to embed in the response. Common values: ‘contact’ (contact person), ‘contactPerson’ (deprecated, use ‘contact’)
integer
Maximum number of credit notes to return, must be >= 1
string
Sort order for results, e.g., ‘date_create DESC’
integer
Number of credit notes to skip for pagination, must be >= 0
string
Filter by credit note status code. Common values: 100 (DRAFT), 200 (OPEN), 1000 (PAID)
string
Filter by contact ID
string
Filter by customer ID
string
Filter by customer name
string
Filter by contact surname
string
Filter by credit note number
string
Filter by contact family name
string
Filter by customer number

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_EXPORT_INVOICECSVTool to export invoices as CSV from sevDesk. Use when you need to get invoice data in CSV format. The response contains base64-encoded CSV content when download parameter is false.

Input Parameters

boolean
Specifies if the document is downloaded. Set to false to get base64 encoded content in response
string
Model name which is exported, should be ‘Invoice’ for this endpoint
string
SevQuery object name, should be ‘SevQuery’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_EXPORT_TRANSACTIONS_CSVTool to export check account transactions as CSV file. Use when you need to download or retrieve transaction data in CSV format for reporting or analysis.

Input Parameters

boolean
Whether to trigger a download or return base64 encoded content. Set to false to get CSV content in response.
string
Model name for the query, typically ‘CheckAccountTransaction’
string
Object name for the query, must be ‘SevQuery’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_INVOICE_BY_IDRetrieve one invoice by ID, including its status, totals, and references.

Input Parameters

integer
required
ID of the invoice to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_INVOICE_IS_PARTIALLY_PAIDTool to check if an invoice is already partially paid. Use when you need to determine the partial payment status of a specific invoice.

Input Parameters

integer
required
The unique identifier of the invoice to check partial payment status

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_INVOICE_POSITIONSTool to retrieve all line items (positions) for a specific invoice. Use when you need detailed information about products, services, quantities, and prices on an invoice.

Input Parameters

array
List of related objects to embed in the response (e.g., ‘part’, ‘unity’). Multiple values supported.
integer
Maximum number of positions to return (pagination)
integer
Number of positions to skip before returning results (pagination)
integer
required
ID of the invoice to retrieve positions for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_INVOICE_POSSTool to retrieve invoice positions from sevDesk. Use when you need to fetch line items or positions associated with invoices.

Input Parameters

integer
Retrieve all InvoicePos with this InvoicePos id
integer
Retrieve all invoice positions with this part. Must be provided with part[objectName]
integer
Retrieve all invoice positions with this invoice. Must be provided with invoice[objectName]
string
Only required if part[id] was provided. ‘Part’ should be used as value.
string
Only required if invoice[id] was provided. ‘Invoice’ should be used as value.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_INVOICESRetrieves invoices from sevDesk with optional filters for status, contact, invoice number and individual dates. Supports pagination, sorting and embedding related objects.

Input Parameters

string
Comma-separated list of related objects to embed in the response, e.g., ‘contact,sevClient’
integer
Maximum number of invoices to return per request (pagination)
string
Sort order as JSON array string, e.g., ’[“invoiceDate DESC”]’ or ’[“invoiceNumber ASC”]’
string
Filter by exact invoice number
integer
Number of invoices to skip before returning results (pagination)
string
Full-text search term to filter invoices
string ("DRAFT" | "CONFIRMED" | "PAID" | "CANCELLED")
Filter invoices by their current status
string
Filter by due date (YYYY-MM-DD)
string
Filter invoices by the associated contact’s ID
string
Filter by invoice date (YYYY-MM-DD)
string
Filter by delivery date (YYYY-MM-DD)
string
Filter invoices by customer internal note content

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_LETTERPAPERS_WITH_THUMBTool to retrieve all available letterpapers with thumbnails from sevDesk. Use when you need to view or select letterpapers for documents.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_NEXT_CUSTOMER_NUMBERTool to retrieve the next free customer number from sevDesk. Use when you need to get the next available customer number for creating a new contact.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_ORDER_BY_IDRetrieves details of a specific sevDesk order by ID, including customer, amounts and status.

Input Parameters

integer
required
The unique ID of the order to retrieve from sevDesk

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_ORDER_DISCOUNTSTool to retrieve discounts applied to a specific order in sevDesk. Use when you need to find all discount entries associated with an order.

Input Parameters

string
Comma-separated list of related data to embed in the response. Can handle multiple values separated by comma.
integer
Maximum number of discounts to return (pagination)
integer
Number of discounts to skip before returning results (pagination)
integer
required
ID of the order to retrieve discounts for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_ORDER_POS_BY_IDTool to retrieve details of a specific order position by ID. Use when you have an order position’s ID and need its detailed information including quantity, price, tax rate, and discounts.

Input Parameters

integer
required
The unique ID of the order position to retrieve from sevDesk

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_ORDER_POSITIONSTool to retrieve order positions from SevDesk. Use when you need to fetch line items or positions associated with orders.

Input Parameters

integer
Retrieve all order positions belonging to this order. Must be provided with order[objectName]
string
Only required if order[id] was provided. ‘Order’ should be used as value.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_ORDERSRetrieve a paginated list of orders from sevDesk. This action fetches orders with support for filtering by status, customer, search text, and pagination. All parameters are optional - calling without parameters returns all orders. Use ‘embed’ to include related data like contact information or addresses in a single request.

Input Parameters

string
Comma-separated related data to embed in the response. Common values: ‘contact’ (customer information), ‘address’ (delivery address). Example: ‘contact,address’
integer
Maximum number of orders to return
string ("asc" | "desc")
Sort direction, either ‘asc’ or ‘desc’
integer
Zero-based offset for pagination
Free-text search filter for orders
string
Filter orders by status code. Common values: 100 (draft), 200 (open), 500 (cancelled), 1000 (completed). Can be a single status or comma-separated list
string
Filter orders by contact/customer ID. Use the numeric ID of the contact (e.g., ‘12345’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_PART_BY_IDTool to retrieve details of a specific part by ID. Use when you have a part’s ID and need its detailed information including pricing, stock levels, and metadata.

Input Parameters

integer
required
The unique ID of the part to retrieve from sevDesk

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_PART_CONTACT_PRICESTool to retrieve a list of part contact prices. Use when you need to fetch pricing details for parts linked to contacts, with optional filters, pagination, and embedding of related objects.

Input Parameters

string
Filter results by part ID (numeric string). The action automatically formats this as an object reference for the API.
string
Comma-separated related entities to embed, e.g., ‘part,contact’
integer
Maximum number of price entries to return, must be >= 1
string
Comma-separated list of specific fields to include in response
integer
Number of entries to skip for pagination, must be >= 0
string
Filter results by contact ID (numeric string). The action automatically formats this as an object reference for the API.
string
Only show records updated after this ISO-8601 datetime
boolean
Include deleted price entries when true

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_PARTSList sevDesk parts (products or services) for selection. Use limit and offset to paginate results, filter by archived status, and optionally request related objects or a total count. When no part data is returned, the tool returns an empty list.

Input Parameters

string
Comma-separated list of related objects to embed in the response, e.g., ‘partUnity’ for unit details, ‘partSupplier’ for supplier info, ‘partPrice’ for pricing
integer
Maximum number of results to return (1-1000)
integer
Number of items to skip for pagination
boolean
Filter for archived parts. Set to true to retrieve only archived parts, false for non-archived, or omit to get all
boolean
When set to true, includes the total count of available records in the response
string
Comma-separated list of part properties to filter or return

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_PART_STOCKTool to retrieve the current stock level of a specific part. Use when you need to check inventory availability for a product or service.

Input Parameters

integer
required
ID of part for which you want the current stock.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_PART_UNITIESRetrieves a list of part unities (units of measurement) from SevDesk. Part unities represent units of measurement used for products/parts in the system (e.g., pieces, meters, kilograms, hours). Use this action to list all available units, with optional pagination and filtering for deleted entries.

Input Parameters

string
Comma-separated list of related objects to embed (e.g., ‘customer,contact’)
integer
Maximum number of part unities to return (default: 100)
integer
Number of items to skip for pagination (default: 0)
boolean
Whether to include deleted part unities in the results (default: false)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_PAYMENT_METHODSRetrieves all available payment methods from sevDesk. Payment methods define how customers pay invoices (e.g., SEPA bank transfer, cash, check, online payment like PayPal). Use this to list payment methods before creating invoices or to display payment options. Supports pagination via limit and offset parameters.

Input Parameters

string
Comma-separated list of related object keys to include in the response. Contact sevDesk API documentation for available embed options for PaymentMethod.
integer
Maximum number of payment methods to return in the response. Use this for pagination to control result size.
integer
Number of payment methods to skip before returning results. Use with ‘limit’ for pagination (e.g., offset=10 with limit=10 gets items 11-20).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_PLACESRetrieve a list of places (cities/locations with geographic data) from sevDesk. Places contain location information including city names, coordinates (latitude/longitude), postal codes, and location IDs. Useful for address validation, geographic lookups, or populating location dropdowns in your application. Use pagination (limit/offset) to handle the large dataset efficiently (45,000+ places).

Input Parameters

integer
Level of embedding for related objects. Must be a non-negative integer.
string
Comma-separated list of related objects to embed, e.g., ‘parentPlace’.
integer
Maximum number of places to return (pagination). Must be ≥ 1.
integer
Number of places to skip before returning results (pagination). Must be ≥ 0.
boolean
If true, include the total count of matching places in the response metadata.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_PRIVATE_TRANSACTION_RULESTool to list existing private transaction rules in SevDesk. Use when you need to retrieve all rules that automatically mark transactions as private based on counterpart name or payment purpose. This is useful for reviewing configured rules for separating personal transactions from business ones.

Input Parameters

string
Comma-separated list of related objects to embed in the response, e.g., ‘sevClient’
integer
Maximum number of rules to return per request (pagination)
integer
Number of rules to skip before returning results (pagination)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_PROGRESSTool to retrieve the progress of an export operation. Use when you need to check the status of a running export by its hash identifier.

Input Parameters

string
required
The hash string of an export to check progress for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_RECEIPT_GUIDANCE_FOR_ACCOUNT_NUMBERTool to retrieve receipt guidance for a specific Datev account number. Use when you need to understand what receipt types and tax rules are allowed for a particular account in the accounting system.

Input Parameters

integer
required
The datev account number you want to get additional information of

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_RECEIPT_GUIDANCE_FOR_ALL_ACCOUNTSRetrieve receipt guidance for all accounts, including available booking accounts and their allowed tax rules and receipt types.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_RECEIPT_GUIDANCE_FOR_EXPENSETool to retrieve guidance for expense accounts from sevDesk. Use when you need to determine which expense accounts are available and which tax rules and receipt types are compatible with them. This helps ensure correct account selection based on client settings and tax requirements.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_RECEIPT_GUIDANCE_FOR_REVENUETool to retrieve guidance for revenue accounts from sevDesk. Use when you need to determine which revenue accounts are available and which tax rules and receipt types are compatible with them. This helps ensure correct account selection based on client settings and tax requirements.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_RECEIPT_GUIDANCE_FOR_TAX_RULETool to get guidance by tax rule from sevDesk. Use when you need to determine which booking accounts are compatible with a specific tax rule. This helps ensure proper account selection for vouchers and invoices, preventing validation errors. Returns a list of accounts with allowed receipt types and tax rules.

Input Parameters

string
required
The code of the tax rule you want to get guidance for (e.g., ‘USTPFL_UMS_EINN’, ‘AUSFUHREN’, ‘INNERGEM_LIEF’). This determines which booking accounts are compatible with the specified tax rule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_REPORT_INVOICELISTExport a sevDesk invoice list report, typically as a PDF. Raw PDF responses are returned as base64-encoded content; JSON report responses are passed through.

Input Parameters

string
required
The view type for the invoice report (e.g., ‘all’ for all invoices)
boolean
Specifies if the document is downloaded. Set to false to get base64 encoded content in response
integer
Maximum number of invoices to include in the report
string
Model name which is exported, should be ‘Invoice’ for this endpoint
string
SevQuery object name, should be ‘SevQuery’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_REPORT_ORDERLISTTool to export the order list report from sevDesk. Use when you need to generate a report of orders. The report is typically returned as a base64-encoded PDF file that can be decoded and saved.

Input Parameters

string
required
View filter for the report. Use ‘all’ to export all orders
boolean
Whether to download the report. Set to true to force download
integer
Limit the number of orders to include in the exported report
string
Model name for the sevQuery object. Should be ‘Order’ for orderlist
string
Object name for the sevQuery. Typically ‘SevQuery’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_SEV_CLIENT_CONFIGRetrieves the sevClient configuration settings from sevDesk. This endpoint returns comprehensive configuration information including taxation settings, decimal precision for prices/quantities, payment integrations (PayPal, Stripe), document printing preferences, and various system settings. Use this to understand the current configuration state of the sevDesk client. No parameters are required, but you can optionally use the ‘embed’ parameter to get additional embedded information like full sevClient details.

Input Parameters

string
Get additional information. Can contain multiple values separated by comma. Example: ‘sevClient’ to embed sevClient details.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_TAG_BY_IDTool to retrieve details of a specific tag by ID. Use when you have a tag’s ID and need its detailed information.

Input Parameters

integer
required
ID of tag to return

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_TAG_RELATIONSTool to retrieve tag relations from sevDesk. Use when you need to fetch associations between tags and other objects like contacts, invoices, or orders.

Input Parameters

array
List of related objects to embed in the response, e.g., [‘tag’, ‘object’]
integer
Maximum number of tag relations to return. Defaults to 100
integer
Number of tag relations to skip before returning results (pagination)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_TAGSRetrieve sevDesk tags, optionally filtering by ID or name. A 404 response is returned as an empty tag list.

Input Parameters

integer
ID of the Tag to filter by
string
Name of the Tag to filter by

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_TAX_RULESRetrieve sevDesk tax rules for understanding tax treatment and selecting rules for transactions. Results may include names, descriptions, codes, and country information; pagination is supported.

Input Parameters

string
Embed related resources to get full details instead of just references. Use ‘countryClient’ to get complete country information. Multiple resources can be comma-separated.
integer
Maximum number of tax rules to return
integer
Number of tax rules to skip for pagination
boolean
Include deleted tax rules in the response

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_TOOLS_BOOKKEEPING_SYSTEM_VERSIONTool to retrieve the bookkeeping system version from sevDesk. Use when you need to check which bookkeeping system version (1.0 or 2.0) is currently configured for the sevDesk client. This is useful for determining which features and endpoints are available based on the accounting system in use.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_VOUCHER_BY_IDRetrieve one sevDesk voucher by its ID.

Input Parameters

integer
required
ID of the voucher to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_VOUCHER_POSITIONSRetrieve voucher line items, optionally filtered to one voucher.

Input Parameters

string
Related objects to embed in the response, as accepted by sevDesk (for example, ‘voucher’).
integer
Only return positions belonging to this voucher ID. The required Voucher object type is added automatically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_GET_VOUCHERSRetrieve and filter a paginated list of sevDesk vouchers.

Input Parameters

boolean
Exclude recurring vouchers
array
Require vouchers to have each listed tag
integer
Filter by voucher year
string
Comma-separated related resources to embed
integer
Maximum vouchers to return, from 1 to 1000
integer
Filter by voucher month
integer
Number of vouchers to skip
integer ("50" | "100" | "1000")
Voucher status: 50 draft, 100 open, or 1000 paid
string
Maximum voucher date using sevDesk’s documented timestamp or date value
boolean
Include the total matching voucher count
number
Documented upper amount boundary, with sevDesk’s special handling for negative values
integer
Filter by origin resource ID
string
Minimum voucher date using sevDesk’s documented timestamp or date value
integer
Filter by supplier contact ID
boolean
Return only delinquent vouchers
string
Maximum voucher payment date
string
Filter by text in a voucher position comment
string
Filter vouchers created after this documented timestamp value
string ("C" | "D")
Return only credit or debit vouchers
boolean
Return only vouchers with an attached document
number
Documented lower amount boundary, with sevDesk’s special handling for negative values
string
Filter vouchers updated after this documented timestamp value
string ("VOU" | "RV")
Filter normal or recurring vouchers
string
Filter vouchers created before this documented timestamp value
boolean
Order vouchers by debit
string
Minimum voucher payment date
string
Filter by supplier name
string
Filter vouchers updated before this documented timestamp value
integer
Filter by cost centre ID
Search voucher, position, and contact text
string
Filter by text contained in the voucher description
boolean
Exclude catering vouchers
integer
Filter by a linked object’s ID
integer
Filter by a position’s accounting type ID
string
Linked resource type; required with linked_object_id
string
Origin resource type; required with origin_id
string
Contact resource name; required with contact_id
integer
Filter by a contact or linked object ID
string ("ASC" | "DESC")
Order by voucher number
string
Comma-separated resource types included in full-text search
string
Contact or linked resource type; required with contact_or_object_id
string
Cost centre resource name; required with cost_centre_id
string
Search position comments and voucher descriptions
string
Accounting type resource name; required with accounting_type_id

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_RENDER_INVOICETool to render the PDF document of an invoice by its ID. Use when you need to generate or regenerate the PDF representation of an invoice.

Input Parameters

integer
required
The unique identifier of the invoice to render as PDF
boolean
Define if a forceful re-render should occur. Set to true to force regeneration of the PDF document.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_RESET_CREDIT_NOTE_TO_OPENTool to reset a credit note status to open. Use when you need to revert a credit note from a higher status back to open status.

Input Parameters

integer
required
ID of the credit note to reset to open status

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_RESET_INVOICE_TO_OPENLower a non-recurring invoice above Open to Open and unlink transactions. This cannot promote a Draft invoice. The invoice and its linked transactions must not be enshrined.

Input Parameters

integer
required
ID of the invoice to reset to open status

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_RESET_VOUCHER_STATELower a voucher’s state to open or draft. This mutates the voucher, unlinks linked payments, and resets created asset depreciation. It cannot increase draft to open or change an enshrined voucher.

Input Parameters

string ("open" | "draft")
required
Target state. This reset unlinks linked payments and resets created asset depreciation. It cannot change draft to open, and enshrined vouchers cannot be reset.
integer
required
ID of the voucher whose state will be lowered.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_SAVE_INVOICECreate a sevDesk invoice using the factory endpoint with line items, tax information and optional discounts. The request can also specify an invoice position or discount to delete.

Input Parameters

object
required
Invoice data with all required fields
string
Filename of a previously uploaded file which should be attached
array
Array of discounts to save
object
Reference to a discount to delete.
array
required
Array of invoice positions (line items) to save
object
Reference to an invoice position to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_SAVE_ORDERCreate a sevDesk draft order together with its line items.

Input Parameters

object
required
Order header and customer data
array
Order positions to create with the order

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_SAVE_VOUCHERCreate a voucher or update a draft voucher and its positions. An update can also specify a voucher position to delete.

Input Parameters

object
required
Voucher data
string
Internal filename returned by the voucher upload endpoint
array
required
Voucher positions to save
object
Voucher position removed while updating a draft.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_SEND_CREDIT_NOTE_BYTool to mark a credit note as sent by updating its send status and type. Use when you need to record that a credit note has been sent to the customer via print, postal, mail, or PDF download. Set sendDraft to false to actually mark it as sent.

Input Parameters

string ("VPR" | "VP" | "VM" | "VPDF")
required
Specifies the way in which the credit note was sent to the customer. VPR (print), VP (postal), VM (mail), VPDF (downloaded pdf)
boolean
required
To create a draft of a credit note for internal use. This operation will not alter the status of the credit note or create bookings for reports. Set to false to mark as actually sent.
integer
required
ID of credit note to mark as sent

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_SEND_CREDIT_NOTE_BY_WITH_RENDERTool to send a credit note by printing and render it. Use when you need to print a credit note and get render information including document ID and page count.

Input Parameters

string
required
The type you want to print. Use ‘PRN’ for printing.
integer
required
ID of the credit note to send by printing

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_SEND_INVOICE_BYTool to mark an invoice as sent by specifying how it was sent to the customer. Use when you need to update an invoice’s send status after it has been delivered via print, postal mail, email, or PDF download.

Input Parameters

string ("VPR" | "VP" | "VM" | "VPDF")
required
Specifies the way in which the invoice was sent to the customer. VPR = print, VP = postal, VM = mail, VPDF = downloaded PDF
integer
required
The unique identifier of the invoice to mark as sent
boolean
required
To create a draft of an invoice for internal use. This operation will not alter the status of the invoice or create bookings for reports

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_SEND_ORDER_BYTool to mark an order as sent in sevDesk. Use when you need to update an order’s send status after delivering it to the customer. Specify the send type (print, postal, mail, or PDF download) and whether to create a draft.

Input Parameters

integer
required
ID of the order to mark as sent
string ("VPR" | "VP" | "VM" | "VPDF")
required
Specifies the way in which the order was sent to the customer. VPR (print), VP (postal), VM (mail), or VPDF (downloaded pdf)
boolean
required
To create a draft of an order for internal use. This operation will not alter the status of the order if set to true

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_ACCOUNTING_CONTACT_BY_IDTool to update an existing accounting contact in SevDesk. Use when you need to modify creditor or debitor numbers for a contact.

Input Parameters

object
Reference to a contact object in SevDesk.
integer
Debitor number of the accounting contact
integer
Creditor number of the accounting contact
integer
required
ID of the accounting contact to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_CHECK_ACCOUNTUpdates an existing check account (bank account) in sevDesk by ID. Use this tool to modify bank account details such as bank name, IBAN, BIC, account holder, account number, or status flags (active/default). All fields except ‘id’ are optional - only provide the fields you want to update. Returns the complete updated check account object. Common use cases: - Update banking information (IBAN, BIC, bank name) - Change account holder details - Set account as active/inactive or default/non-default - Add or modify account description

Input Parameters

integer
required
The unique identifier of the check account to update
string
Business Identifier Code / SWIFT code (e.g., ‘COBADEFFXXX’)
string
International Bank Account Number in standard format (e.g., ‘DE89370400440532013000’)
boolean
Set to true to activate the account, false to deactivate it
boolean
Set to true to make this the default account, false otherwise
string
Bank code - BLZ for German banks (8 digits) or international bank code
string
Name of the bank where the account is held (e.g., ‘Deutsche Bank’, ‘Sparkasse’)
object
Reference to a sevDesk customer or contact object.
string
Free-text description or notes for this account
string
Full name of the account holder or company
string
Bank account number (national format)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_CHECK_ACCOUNT_TRANSACTION_BY_IDTool to update an existing check account transaction in sevDesk. Use when you need to modify transaction details such as amount, payment purpose, payee/payer name, or status. Only provide the fields you want to update - all fields except checkAccountTransactionId are optional. Common use cases include correcting transaction amounts, updating payment descriptions, or changing transaction status. Returns the complete updated transaction object.

Input Parameters

number
Amount of the transaction (can be positive or negative)
string ("created" | "linked" | "private" | "auto_booked" | "booked")
Status of the check account transaction.
string
Date the transaction was imported in ISO 8601 format (YYYY-MM-DDTHH:MM:SS+TZ)
string
Date the transaction was booked in ISO 8601 format (YYYY-MM-DDTHH:MM:SS+TZ)
object
Reference to a check account.
string
Purpose of the transaction (payment description)
string
Name of the payee or payer (the other party in the transaction)
object
Reference to a check account transaction.
object
Reference to a check account transaction.
integer
required
ID of the check account transaction to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_COMMUNICATION_WAY_BY_IDTool to update an existing communication way by ID in sevDesk. Use when you need to modify contact information such as email addresses, phone numbers, or websites. Only provide the fields you want to update.

Input Parameters

object
Reference to a communication way key object in sevDesk.
boolean
Defines whether the communication way is the main communication way for the contact.
string ("EMAIL" | "PHONE" | "WEB" | "MOBILE")
Type of communication way.
string
The value of the communication way. For example the phone number, e-mail address or website.
object
Reference to a contact object in sevDesk.
integer
required
ID of CommunicationWay to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_CONTACTTool to update an existing contact’s details. Use after confirming the contact ID. Example: “Update contact with ID 123e4567-e89b-12d3-a456-426614174000”.

Input Parameters

string
required
UUID of the contact to update
string
Company name, for COMPANY type
string
Title
string ("m" | "w" | "d")
Gender: m=male, w=female, d=diverse
object
Postal address for the contact
object
Identifier for a contact category in SevDesk
string
Last name, for PERSON type
string
First name, for PERSON type
string
Tax number
string
VAT number
string
Family name, for PERSON type
string
Salutation
object
Bank account details for the contact
string
Free-text notes
string
Credit number
string
Academic title (e.g., Dr.)
string
Customer number

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_CONTACT_ADDRESS_BY_IDTool to update an existing contact address by its unique identifier. Use when you need to modify street, city, zip code, name, or other address details of an existing contact address.

Input Parameters

string
Zip code
string
City name
string
Name in address
string
Second name in address
string
Third name in address
string
Fourth name in address
string
Street name
object
Contact reference to which this address belongs
object
Country reference for the contact address
object
Category reference for the contact address
integer
required
ID of contact address to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_CONTACT_CUSTOM_FIELD_BY_IDTool to update a contact custom field in SevDesk. Use when you need to modify the value of an existing custom field for a contact.

Input Parameters

string
required
The new value for the contact custom field
object
required
Reference to the contact this custom field belongs to
string
Internal object name which is ‘ContactCustomField’
integer
required
The unique ID of the contact custom field to update
object
required
Reference to the contact custom field setting that defines this field

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_CONTACT_CUSTOM_FIELD_SETTING_BY_IDTool to update an existing contact custom field setting in SevDesk. Use when you need to modify the name or description of a custom field configuration for contacts.

Input Parameters

string
Name of the contact field
string
Internal object name which is ‘ContactCustomFieldSetting’
string
The description of the contact field
integer
required
ID of contact field setting you want to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_INVOICE_PARAMETERTool to update an invoice parameter such as template, language, letterpaper, or PayPal settings. Use when you need to change the layout or configuration of an existing invoice.

Input Parameters

string ("language" | "template" | "letterpaper" | "payPal")
required
The parameter type to change (language, template, letterpaper, or payPal)
string
required
The ID/value of the template, letterpaper, language, or payPal setting
integer
required
ID of the invoice to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_INVOICE_POSITIONPartially update editable fields on an existing sevDesk invoice line item.

Input Parameters

string
Name of the article or part
object
Inventory part assigned to an invoice position.
string
Detail text for the position
number
Gross or net unit price, depending on account settings
object
Unit of measurement assigned to an invoice position.
number
Discount on the position
number
Quantity of the part
number
Tax rate of the position
number
Tax amount on the unit price
number
Gross unit price
integer
Position number used to order line items
integer
required
ID of the invoice position to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_ORDER_BY_IDTool to update an existing order in sevDesk by ID. Use when you need to modify order details like header, customer notes, or text fields.

Input Parameters

string
Order header - normally consists of prefix plus the order number
object
Origin reference object.
string ("100" | "200" | "300" | "500" | "750" | "1000")
Status of the order.
object
Tax set reference object for sevdesk-Update 1.0.
string
Complete address of the recipient including name, street, city, zip and country. Line breaks can be used and will be displayed on the invoice pdf
object
Contact reference object.
integer
required
ID of the order to update
boolean
If true, the net amount of each position will be shown on the order. Otherwise gross amount
number
This is not used anymore. Use the taxRate of the individual positions instead
object
Tax rule reference object for sevdesk-Update 2.0.
string
A common tax text would be ‘Umsatzsteuer 19%’
string
Use this in sevdesk-Update 1.0 (instead of taxRule). Tax type: ‘default’, ‘eu’, ‘noteu’, ‘custom’, ‘ss’
integer
Version of the order. Can be used if you have multiple drafts for the same order. Should start with 0
string
Currency used in the order. Needs to be currency code according to ISO-4217
string
Footer text for the order. Certain html tags can be used here to format your text
string
Header text for the order. Certain html tags can be used here to format your text
string
The date the order was sent to the customer. Needs to be provided as timestamp
string ("VPR" | "VPDF" | "VM" | "VP")
Type which was used to send the order.
string
Order date. Needs to be provided as timestamp or dd.mm.yyyy format
string ("AN" | "AB" | "LI")
Type of the order.
string
Payment terms of the order
object
Contact person reference object.
string
Delivery terms of the order
object
Country reference object.
boolean
Defines if the client uses the small settlement scheme. If yes, the order must not contain any vat
string
Internal note of the customer. Contains data entered into field ‘Referenz/Bestellnummer’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_ORDER_POSITIONPartially update editable fields on an existing sevDesk order line item.

Input Parameters

string
Name of the article or part
object
Inventory part assigned to an order position.
string
Detail text for the position
object
Order assigned to an order position.
number
Gross or net unit price, depending on account settings
object
Unit of measurement assigned to an order position.
number
Tax rate of the position
number
Discount on the position
boolean
Whether the position is optional
number
Tax amount on the unit price
number
Quantity of the part
integer
required
ID of the order position to update
number
Gross unit price
integer
Position number used to order line items

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_ORDER_TEMPLATETool to update an order parameter such as template, language, letterpaper, or PayPal settings. Use when you need to change the layout or configuration of an existing order.

Input Parameters

string ("language" | "template" | "letterpaper" | "payPal")
required
The parameter type to change (language, template, letterpaper, or payPal)
string
required
The ID/value of the template, letterpaper, language, or payPal setting
integer
required
ID of the order to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_PART_BY_IDTool to update an existing part (product/service) in sevDesk. Use when you need to modify part details like name, stock, price, tax rate, or status.

Input Parameters

string
Name of the part
string
A text describing the part
number
Net price for which the part is sold. This parameter will be deprecated - use priceNet or priceGross instead
number
The stock of the part
object
Reference to a unity (unit of measurement) object
integer
required
ID of the part to update
string ("inactive" | "active")
Status of the part in sevDesk
number
Tax rate of the part (e.g., 19 for 19%)
object
Reference to a category object
number
Net price for which the part is sold
string
The part number
number
Gross price for which the part is sold
boolean
Defines if the stock should be enabled
number
Purchase price of the part
string
An internal comment for the part. Does not appear on invoices and orders

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_SEV_CLIENT_EXPORT_CONFIGTool to update the export configuration for a SevClient in sevDesk. Use when you need to configure export settings including accountant number, accountant client number, and accounting year begin timestamp. This endpoint requires the SevClient ID and all three configuration parameters.

Input Parameters

integer
required
ID of the SevClient to update the export config for
integer
required
Accountant number for the export configuration
integer
required
Accounting year begin timestamp (Unix timestamp in seconds)
integer
required
Accountant client number for the export configuration

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_TAG_BY_IDTool to update a tag’s name in sevDesk by its ID. Use when you need to rename or modify an existing tag.

Input Parameters

string
required
The name of the tag you want to update
integer
required
ID of tag you want to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPDATE_VOUCHERUpdate simple fields on an existing draft voucher.

Input Parameters

object
Legacy custom tax set assigned to a voucher.
string
Voucher currency code
object
Document attached to a voucher.
string
Payment date as a timestamp or dd.mm.yyyy
object
Supplier contact assigned to a voucher.
object
Tax rule used by sevDesk Update 2.0.
string ("default" | "eu" | "noteu" | "custom" | "ss")
Legacy Update 1.0 tax type
integer
required
ID of the draft voucher to update
object
Cost centre assigned to a voucher.
string
Voucher description, typically its number
string ("C" | "D")
Whether the voucher is credit or debit
string
Voucher date as a timestamp or dd.mm.yyyy
string ("VOU" | "RV")
Normal or recurring voucher type
string
Delivery date as a timestamp or dd.mm.yyyy
string
Supplier name used when no supplier reference is provided
string
Voucher payment deadline
string
End of the delivery date range
number
Explicit foreign currency exchange rate
string
Date used by sevDesk to determine the exchange rate

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVDESK_UPLOAD_VOUCHER_FILEUpload a temporary document and return its filename for Save Voucher.

Input Parameters

object
required
Voucher document uploaded through Composio file storage.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not