Zapier

The Tyms app for Zapier connects your Tyms books to the other tools you use: payment processors, banks, stores, CRMs, payroll and more. When something happens in one app, Zapier records it in Tyms, or the other way round.

Tyms on Zapier

Open the Tyms app on Zapier to browse ready-made integrations and start a Zap.

Before you start

A Tyms business with an active Tyms subscription.
A Zapier account. Multi-step Zaps, such as the find-then-act examples below, need a paid Zapier plan.
Access to Settings → Business in Tyms, so you can copy the secret key.

Connect your Tyms business

Copy your secret key

In Tyms, go to Settings → Business and open the Developer API tab. Copy the secret key (it starts with tyms_sk_).

Add Tyms to a Zap

In Zapier, create a Zap and search for Tyms as the trigger or action app. You can also start from the Tyms page on Zapier.

Paste the key

When Zapier asks you to sign in, paste the secret key. The connection shows your business name and currency, so you can tell businesses apart if you connect more than one.

The secret key gives full access to the business’s books. Don’t share it. If it leaks, generate a new one in the Developer API tab and reconnect Tyms in Zapier.

Triggers

Triggers start a Zap when something happens in Tyms. Zapier checks for new data every few minutes.

Trigger	Fires when
New / Updated Invoice	An invoice is created or changed
Invoice Paid, Invoice Overdue	An invoice is fully paid, or passes its due date unpaid
New / Updated Bill	A bill is created or changed
Bill Paid, Bill Overdue	A bill is fully paid, or passes its due date unpaid
New / Updated Expense, Income, Quote, Purchase Order	That record is created or changed
New / Updated Contact	A customer or vendor is added or changed
New / Updated Bank Transaction	A bank line is added or changed
New Uncategorized Bank Transaction	A bank line still needs categorising
New / Updated Journal Entry	A journal is posted or changed
New / Updated Inventory Item	A stock item is added or changed
New / Updated Project	A project is added or changed
New Fixed Asset	A fixed asset is added

Actions

Everyday records

Every Tyms record has Create, Update and Delete actions: invoices, bills, expenses, income, quotes, purchase orders, contacts, bank accounts, bank transactions, journal entries, chart of accounts, taxes, inventory, fixed assets, projects, departments and branches.

Invoice, bill, expense, income, quote and purchase order actions take a customer or vendor name or email. If the contact doesn’t exist yet, Tyms creates it (you can turn this off).
Create Invoice, Create Bill, Create Expense, Create Income and Create Journal Entry save the record as a Draft by default. A draft is not posted to the ledger, so it doesn’t show in your reports until you open it in Tyms and post it. To post straight away, set Status to Pending (invoices and bills) or Published (expenses, income and journals).
Line items, taxes, discounts, branches, departments and projects are all available as fields.
Delete can’t be undone. A contact used on any record can’t be deleted.

Built for common integrations

Action	Use it with	What it does
Record Payment Received	Stripe, Paystack, Flutterwave, PayPal, Square	Pays the matching open invoice, or records a sale. Can also record the processor fee as an expense.
Record Refund	Payment processors	Records the refund as a journal entry.
Record Transfer Between Accounts	Banks, wallets	Records a transfer between two accounts, with an optional fee.
Record Sales Order	Shopify, WooCommerce and other stores	Creates the customer and order lines, matches SKUs to stock, and records a paid sale or an unpaid invoice.
Sell Inventory, Restock Inventory	Stores, POS	Moves stock in or out.
Record Payroll Run	Google Sheets, Airtable or any app with pay-run totals	Posts one balanced payroll journal: gross pay, employer contributions, net pay, PAYE, pension and other deductions.
Record Invoice Payment, Record Bill Payment	Any	Records a payment against an existing invoice or bill.
Convert Quote, Receive Purchase Order	Any	Turns a quote into an invoice or sale, or a purchase order into stock.
Attach File to Record	Email, Drive, Dropbox	Attaches a receipt or document to a Tyms record.
Import Bank Statement (AI)	Email, banks	Tyms AI reads a statement file or bank alert and adds the transactions.
Create Record From Text or File (AI)	Email, forms, chat	Tyms AI creates an invoice, bill, expense, journal or contact from plain text or a receipt.
API Request (Advanced)	Any	Calls any Tyms API endpoint with your connected key.

The “Record …” actions write entries in your books. They don’t move any money.

Stripe, Paystack and other apps that send amounts in cents

Some payment apps send amounts in the smallest unit of the currency. Stripe sends $1,970.00 as 197000 (cents), and Paystack sends ₦5,000 as 500000 (kobo). In Record Payment Received, Record Refund and Record Transfer Between Accounts, set Amounts are in cents to Yes for these apps. Tyms then divides the amount and the processing fee by 100, so your books show 1,970.00 and 5,000.00. Leave it off for apps that send normal amounts, such as PayPal, Shopify and WooCommerce. Currencies with no minor unit, such as the Japanese yen, are never divided. The payment, order, payroll and transfer actions use the external reference (for example the Stripe charge ID or Shopify order number) as the Tyms document number. If Zapier replays a step, Tyms finds the existing record and returns it instead of creating a duplicate. AI actions use your Tyms AI credits.

Searches

Searches look up a Tyms record so later steps can use it.

Find any record by ID, number, email, SKU, account number or keyword.
Find or create for invoices, bills, contacts, inventory and projects: if nothing matches, Zapier creates it.
Find Financial Report: profit and loss, balance sheet, trial balance, cash flow or general ledger for a period.
Find Contact Statement, Find Account Ledger and Find Project Statement for a period.

Example Zaps

Stripe payment → Tyms

Trigger: Stripe, New Payment.
Action: Tyms, Record Payment Received. Map the charge ID to Reference, the amount, the customer email and the processor fee.

Shopify order → Tyms sale

Trigger: Shopify, New Paid Order.
Action: Tyms, Record Sales Order. Map the order number, customer and line items (SKU, quantity, price).

Overdue invoice → Slack reminder

Trigger: Tyms, Invoice Overdue.
Action: Slack, Send Channel Message with the customer name, invoice number and balance.

Receipt email → Tyms expense

Trigger: Gmail, New Attachment.
Action: Tyms, Create Record From Text or File (AI). Pass the attachment and Tyms AI records the expense.

Monthly P&L → email

Trigger: Schedule by Zapier, Every Month.
Search: Tyms, Find Financial Report (income statement, last month).
Action: Gmail, Send Email with net profit.

Troubleshooting

Message	What to do
Your Tyms key is invalid or was revoked	Copy a fresh secret key from the Developer API tab and reconnect Tyms in Zapier.
Kindly select a valid contact	Turn on Create missing contact, or pick a contact from the dropdown.
Debits and credits don’t balance	In journal, refund or payroll actions, check that the amounts add up.
Too many requests	Tyms limits API calls per business. Zapier retries automatically.
A trigger doesn’t fire	Polling triggers only pick up records created after the Zap is turned on.
A record from Zapier is missing from reports	It was saved as a draft. Open it in Tyms and post it, or set Status to Pending or Published in the action.

Get help

A Zap isn’t working: contact Zapier support. They can see your Zap history and will pass any Tyms issue to us with the details we need.
A question about your books or your Tyms key: email developer@tyms.io.

For API error codes, see Error handling.

Getting started

Distribution Partners

Guides

Tyms on Zapier

Before you start

Connect your Tyms business

Triggers

Actions

Everyday records

Built for common integrations

Stripe, Paystack and other apps that send amounts in cents

Searches

Example Zaps

Troubleshooting

Get help