![\"Run](\"https://run.pstmn.io/button.svg\")
The Klutch API is your gateway to integrating with Klutch, a platform designed to help users manage and automate their scheduling, availability, and time coordination. Whether you're building a personal integration or a full-featured miniapp for others, the Klutch API gives you the tools to create seamless, time-saving experiences.
\nKlutch helps users stay in control of their time. With smart scheduling, streamlined calendar integrations, and powerful automation, Klutch simplifies how people book, manage, and share their availability. The API enables you to tap into this power programmatically — either for yourself or on behalf of other users through miniapps.
\nThe Klutch API is built on GraphQL, offering a flexible and efficient way to query and mutate data. Whether you need to fetch availability, create booking links, or manage user preferences, you can do it all with simple, precise queries.
\nThere are two primary ways to interact with the Klutch API:
\nUse this mode if you're integrating Klutch into your own workflows or building a tool for personal use.
\nAuthenticate with your personal Klutch account.
\nAccess and manage your own data (e.g., availability, bookings, settings).
\nGreat for automating scheduling or integrating Klutch into your personal tools.
\nUse this mode if you're building a miniapp for others to use. Your miniapp will authenticate on behalf of users and act in their context.
\nRegister your miniapp with Klutch.
\nOnce authorized, your miniapp can:
\nCreate cards on behalf of users
\nRead Transactions
\nCreate Spending Controls
\nThis mode is perfect for startups, productivity tools, or any app that wants to offer Klutch’s functionality to its users.
\nWe offer two endpoints: Production and Sandbox.
\nUsers can acccess their own data using the production endpoint.
\nSandbox endpoint is available for Mini-app developers if they need to test from a multi-user perspective.
\nProduction: https://graphql.klutchcard.com/graphql
\nSandbox: https://sandbox.klutchcard.com/graphql
\n
To create an API Key, login to your account and go to \" My Account\" -> \"Developers\"
\nIf you are creating a mini-app, the API Key will be provided to you by our team.
\n","_postman_id":"2aef4083-b3eb-4727-8c39-b88a453216ef","auth":{"type":"bearer","bearer":{"token":""},"isInherited":true,"source":{"_postman_id":"d1b8ed45-576d-414b-96cc-af81a561a68c","id":"d1b8ed45-576d-414b-96cc-af81a561a68c","name":"Klutch Public API","type":"collection"}}},{"name":"Transactions","item":[{"name":"List Transactions","id":"4e5b1068-022a-4b63-bed5-846e3b142009","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","type":"text"}],"body":{"mode":"graphql","graphql":{"query":"query {\r\n transactions {\r\n id\r\n transactionDate\r\n card {\r\n id\r\n }\r\n transactionStatus\r\n transactionType\r\n merchantName\r\n amount\r\n category {\r\n id\r\n name\r\n }\r\n mcc {\r\n code\r\n description\r\n category\r\n }\r\n zipCode\r\n streetAddress\r\n city\r\n state\r\n merchantId\r\n cardPresent\r\n cardHolderPresent\r\n entryMode\r\n terminalType\r\n terminalId\r\n merchantLogo\r\n mid\r\n merchantOfficialPage\r\n merchantPhoneNumber\r\n cardAcceptorId\r\n }\r\n }","variables":""}},"url":"{{klutch-server-endpoint}}","description":"Fetch all transactions for an user
\nFetch all transactions for an user
\nReturns a Paginated List of Transactions:
\n","auth":{"type":"bearer","bearer":{"token":""},"isInherited":true,"source":{"_postman_id":"d1b8ed45-576d-414b-96cc-af81a561a68c","id":"d1b8ed45-576d-414b-96cc-af81a561a68c","name":"Klutch Public API","type":"collection"}},"urlObject":{"host":["{{klutch-server-endpoint}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"adbc50a3-1c28-4db5-9704-3f89ee59eb6a"},{"name":"Group Transactions","id":"7eecbeb2-8c63-4623-8547-77a260ac2adb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer "}],"body":{"mode":"graphql","graphql":{"query":"query($filter: TransactionFilter, $groupByProperty: TransactionGroupByProperty, $operation: GroupByOperation) {\r\n groupTransactions(filter: $filter, groupByProperty: $groupByProperty, operation: $operation) {\r\n key\r\n value\r\n } \r\n}","variables":"{ \r\n \"filter\": {\r\n \"transactionStatus\": [\"PENDING\", \"SETTLED\"],\r\n \"transactionTypes\": [\"CHARGE\"]\r\n },\r\n \"groupByProperty\": \"CATEGORY\",\r\n \"operation\": \"SUM\"\r\n}"}},"url":"{{klutch-server-endpoint}}","description":"Group Transaction by the specified property
\ngroupbyProperty:
\nCARD,\nMERCHANT_NAME,\nTRANSACTION_STATUS,\nTRANSACTION_TYPE,\nCATEGORY\n\ngroupByOperator:
\nSUM,\nCOUNT,\nAVERAGE\n\nFetch all transactions for an user
\nSee List Transactions
\n","auth":{"type":"bearer","bearer":{"token":""},"isInherited":true,"source":{"_postman_id":"d1b8ed45-576d-414b-96cc-af81a561a68c","id":"d1b8ed45-576d-414b-96cc-af81a561a68c","name":"Klutch Public API","type":"collection"}},"urlObject":{"host":["{{klutch-server-endpoint}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"313f7e72-ea25-4e6a-ba6f-4cb02ae18cdf"},{"name":"List Transaction Categories","id":"e0befbfb-37da-4ee6-bb62-4414ac6a0245","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","type":"text"}],"body":{"mode":"graphql","graphql":{"query":"query($id: String) {\r\n transactionCategory(id: $id) {\r\n id\r\n name\r\n mccs\r\n }\r\n}","variables":""}},"url":"{{klutch-server-endpoint}}","description":"List categories
\nFetch all transactions for an user
\nSee List Transactions
\n","auth":{"type":"bearer","bearer":{"token":""},"isInherited":true,"source":{"_postman_id":"d1b8ed45-576d-414b-96cc-af81a561a68c","id":"d1b8ed45-576d-414b-96cc-af81a561a68c","name":"Klutch Public API","type":"collection"}},"urlObject":{"host":["{{klutch-server-endpoint}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"a41c05a8-a000-4b11-881a-3dff05783011"}],"id":"06f80473-ea43-4e64-bfd6-81200ae94e02","_postman_id":"06f80473-ea43-4e64-bfd6-81200ae94e02","description":"","auth":{"type":"bearer","bearer":{"token":""},"isInherited":true,"source":{"_postman_id":"d1b8ed45-576d-414b-96cc-af81a561a68c","id":"d1b8ed45-576d-414b-96cc-af81a561a68c","name":"Klutch Public API","type":"collection"}}},{"name":"Transactions Rules","item":[{"name":"Create Accumulating Over Period Transaction Rule","id":"98697482-7156-4282-8f68-266bea61367f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","type":"text"}],"body":{"mode":"graphql","graphql":{"query":"mutation($name: String, $displayName: String, $cardIds: [String], $spec: TransactionRuleSpecInput) {\r\n createTransactionRule(name: $name, displayName: $displayName, cardIds: $cardIds, spec: $spec) { \r\n id\r\n name\r\n cards {\r\n id\r\n }\r\n createdAt\r\n createdBy {\r\n entityID\r\n type\r\n }\r\n spec {\r\n specType\r\n ... on AccumulatingOverPeriodRuleSpec {\r\n period\r\n amount\r\n filters {\r\n field\r\n value\r\n operator\r\n invert\r\n }\r\n }\r\n ... on DeclineBasedOnFilterRuleSpec {\r\n filter {\r\n field\r\n value\r\n operator\r\n invert \r\n }\r\n }\r\n ... on StartEndRuleSpec {\r\n startDate\r\n endDate\r\n limitAmount\r\n filters {\r\n field\r\n value\r\n operator\r\n invert\r\n }\r\n }\r\n ... on TimeOfDayRuleSpec {\r\n startTime\r\n endTime\r\n }\r\n ... on WeekDayRuleSpec {\r\n daysAllowed\r\n } \r\n }\r\n }\r\n}","variables":"{\r\n\t\"name\": \"SampleAccumulatingOverPeriod\",\r\n \"displayName\": \"Sample Accumulating Over Period\",\r\n \"cardIds\": [\"{{card-id}}\"],\r\n\t\"spec\": {\r\n\t\t\"specType\": \"AccumulatingOverPeriodTransactionRule\",\r\n \"period\": \"MONTH\",\r\n \"amount\": 200.00,\r\n \"filters\": [\r\n {\r\n \"field\": \"MCC\",\r\n \"operator\": \"CONTAINS\",\r\n \"value\": \"[1234]\"\r\n }\r\n ]\r\n\t}\r\n\r\n}"}},"url":"{{klutch-server-endpoint}}","auth":{"type":"bearer","bearer":{"token":""},"isInherited":true,"source":{"_postman_id":"d1b8ed45-576d-414b-96cc-af81a561a68c","id":"d1b8ed45-576d-414b-96cc-af81a561a68c","name":"Klutch Public API","type":"collection"}},"urlObject":{"host":["{{klutch-server-endpoint}}"],"query":[{"disabled":true,"key":"Authentication","value":""}],"variable":[]}},"response":[],"_postman_id":"98697482-7156-4282-8f68-266bea61367f"},{"name":"Create Decline Based On Filter Trasnaction Rule","id":"4617a8da-2e2e-4026-ae3d-5669b0025de2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","type":"text"}],"body":{"mode":"graphql","graphql":{"query":"mutation($name: String, $displayName: String, $cardIds: [String], $spec: TransactionRuleSpecInput) {\r\n createTransactionRule(name: $name, displayName: $displayName, cardIds: $cardIds, spec: $spec) { \r\n id\r\n name\r\n cards {\r\n id\r\n }\r\n createdAt\r\n createdBy {\r\n entityID\r\n type\r\n }\r\n spec {\r\n specType\r\n ... on AccumulatingOverPeriodRuleSpec {\r\n period\r\n amount\r\n filters {\r\n field\r\n value\r\n operator\r\n invert\r\n }\r\n }\r\n ... on DeclineBasedOnFilterRuleSpec {\r\n filter {\r\n field\r\n value\r\n operator\r\n invert \r\n }\r\n }\r\n ... on StartEndRuleSpec {\r\n startDate\r\n endDate\r\n limitAmount\r\n filters {\r\n field\r\n value\r\n operator\r\n invert\r\n }\r\n }\r\n ... on TimeOfDayRuleSpec {\r\n startTime\r\n endTime\r\n }\r\n ... on WeekDayRuleSpec {\r\n daysAllowed\r\n } \r\n }\r\n }\r\n}","variables":"{\r\n\t\"name\": \"SampleDeclineBasedOnFilter\",\r\n \"displayName\": \"Sample Decline Based Filter\",\r\n \"cardIds\": [\"{{card-id}}\"],\r\n\t\"spec\": {\r\n\t\t\"specType\": \"DeclineBasedOnFilterTransactionRule\",\r\n \"filter\": {\r\n \"field\": \"MERCHANT_NAME\",\r\n \"operator\": \"EQUALS\",\r\n \"value\": \"SHADY MERCHANT\"\r\n } \r\n\t}\r\n\r\n}"}},"url":"{{klutch-server-endpoint}}","description":"The following fields are accepted:
\n ADDRESS\n AMOUNT\n CARDHOLDER_PRESENT\n CARD_PRESENT\n CITY\n ENTRY_MODE\n ID\n LEGAL_NAME\n MCC\n MERCHANT_ID\n MERCHANT_NAME\n STATE\n TERMINAL_ID\n ZIP_CODE\n\nThe following operators are accepted:
\n CONTAINS\n EQUALS\n GREATER\n GREATER_EQUALS\n LESS\n LESS_EQUALS\n REGEX_MATCHES\n STARTS_WITH\n\nRequests for MiniApps
\nRequirements:
\nCreate a new payment for your card. There are three possible type of payment: Outstanding Balance, Minimum Due and a Fixed Amount (has to be greater than $15.00 or the minimum due).
\nWhen called this will initiate an ACH from the transfer source to pay the card.
\nList all transfer sources for this user.
\nFunctions that are only available on the sandbox environment to simulate real-world events.
\n","_postman_id":"99621c8f-75a3-4b0d-99d6-57a2aeb615f6","auth":{"type":"bearer","bearer":{"token":""},"isInherited":true,"source":{"_postman_id":"d1b8ed45-576d-414b-96cc-af81a561a68c","id":"d1b8ed45-576d-414b-96cc-af81a561a68c","name":"Klutch Public API","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"token":""}},"event":[{"listen":"prerequest","script":{"id":"dae9af14-fb6e-4f2d-92a2-556e5f7439de","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"7f2dac24-8131-4bb8-8a85-c0bc77804cdb","type":"text/javascript","exec":[""]}}],"variable":[{"id":"0406cd84-bc36-45af-96ee-db38f314ab96","key":"access_token","value":""}]}