> ## Documentation Index > Fetch the complete documentation index at: https://developer.tyms.io/llms.txt > Use this file to discover all available pages before exploring further. # Zapier > Connect Tyms to 7,000+ apps with the Tyms Zapier app: triggers, actions and searches, no code needed 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. > [card] [Tyms on Zapier](https://zapier.com/apps/tyms/integrations) > > 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 **1. Copy your secret key** In Tyms, go to [Settings → Business](https://app.tyms.io/p/settings?view=business) and open the **Developer API** tab. Copy the secret key (it starts with `tyms_sk_`). **2. 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](https://zapier.com/apps/tyms/integrations). **3. 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. > [!WARNING] > > 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](https://developer.tyms.io/api-reference/overview.md) endpoint with your connected key. | > [!NOTE] > > 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 > [accordion] Stripe payment → Tyms > > 1. **Trigger:** Stripe, New Payment. > 2. **Action:** Tyms, Record Payment Received. Map the charge ID to **Reference**, the amount, the customer email and the processor fee. > [accordion] Shopify order → Tyms sale > > 1. **Trigger:** Shopify, New Paid Order. > 2. **Action:** Tyms, Record Sales Order. Map the order number, customer and line items (SKU, quantity, price). > [accordion] Overdue invoice → Slack reminder > > 1. **Trigger:** Tyms, Invoice Overdue. > 2. **Action:** Slack, Send Channel Message with the customer name, invoice number and balance. > [accordion] Receipt email → Tyms expense > > 1. **Trigger:** Gmail, New Attachment. > 2. **Action:** Tyms, Create Record From Text or File (AI). Pass the attachment and Tyms AI records the expense. > [accordion] Monthly P\&L → email > > 1. **Trigger:** Schedule by Zapier, Every Month. > 2. **Search:** Tyms, Find Financial Report (income statement, last month). > 3. **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](https://zapier.com/app/get-help). 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](mailto:developer@tyms.io). For API error codes, see [Error handling](https://developer.tyms.io/guides/error-handling.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.