Markate Connect API Access
\nThe Markate Connect API is offered exclusively to our registered partners and approved Markate customers. It is designed to extend the capabilities of the Markate Service Operations Platform through secure integrations and automation.
\nBefore proceeding, we recommend reviewing our API FAQ for access requirements and usage guidelines:
Markate API FAQ | Connect & Integrate Your Service Operations Platform : Markate Academy
To request access or learn more about API availability, please contact us at api@markate.com.
\nAll requests are reviewed and approved based on use case and alignment with platform guidelines.
\nThe API follows the general patterns of a REST API that accepts form-encoded requests body and returns JSON encoded responses.
\nAPI Base URL
https://www.markate.com
Version History
\n20260507 (latest)
\nadded invoice payments endpoint
\nadded endpoints to upload and get attachments for: estimates, invoices, work_orders, leads
\n20260312
\n20251010
\nadded estimate endpoint
\ncan set tax_rate_id and tax_status to inventory item
\ninventory item returns tax fields
\nfuzzy search for customers, work orders, lead
\nschedule a lead
\nschedule an estimate
\nassign employee to expense
\n20250514
\nadded endpoint to get Tax Rates
\nadded option to send invoices
\nget business returns business timezone
\n20240601
Added new endpoints
invoices
\nexpenses
\nexpense vendors
\nexpense categories
\nexpense attachments
\ncustomer addresses
\ncustomer sources
\nleads
\nlead attachments, stages, labels
\ntasks
\ninventory items
\n20230501
Create event for multiple employees
on Event entity, the event.employee has been removed and replaced with event.employees a list of employees assigned to event
\ncreate event endpoint expects employee to be an array of valid employee ids
\n20210301
First release
Please contact us to get your application credentials needed to connect to Markate API
\nclient_id
Your client_id, Markate we’ll provide this.
client_secret
Your client_secret, Markate we’ll provide this.
redirect_uri
We need from you a list of allowed redirect URI’s for oauth
webhook_secret
A secret key used to validate that requests from webhook are coming from Markate, we’ll provide this
webhook_url
We need from you a webhook URL where the API will post notification events
Create the authorization URL and redirect the user to Markate to login.
\n\nclient_id
your app client_id from Markate
scope
allowed values: read_write or read_only
redirect_uri
the URL to redirect after authorization, has to be in allowed redirect URI’s
response_type
value: code
state
optional, alphanumeric string for CSFR
always_prompt
optional, default false, allowed values true|false
On true will force user to review and reapprove the app scopes and permissions
The browser is redirected to the configured redirect URI. On success you should receive the following query parameters: code=&scope=&state
\ncode
use this authorization code to get the access token for your user
scope
read_write or read_only, depending what you passed on the initial GET request
state
the value passed on GET request
Validation errors will be displayed on Markate authorization page.
\nIf the user will decline the authorization (click on Deny button) it will be redirected to your redirect_uri with following params
\nerror=access_denied&error_description=User denied&state={{your-state-param}}
\nExchange the authorization code for an access token
\nPOST https://www.markate.com/connect/oauth/token
\nThe POST params
\nclient_id
your app client_id from Markate
client_secret
your app client_secret from Markate
code
the code from authorization step
grant_type
authorization_code
redirect_uri
same redirect_uri as on authorization step above
{\n \"access_token\":\"028e4c7b3205b5b30afc573658e74613b39c82a6c172041566d46fd47f3dfb5a\",\n \"refresh_token\":\"59fcc38f3d2c961335abb1d16058c06a0df1bf5879ba85397c8af2b8b0880562\",\n \"expires_in\":\"604800\",\n \"expires_on\":\"2021-03-17T13:04:54+00:00\",\n \"token_type\":\"bearer\",\n \"markate_user_id\":\"eR6yNK2wLkZzrkYgEvZz\",\n}\n\nA 400 bad request response is returned with body
\n{\n \"error\": \"invalid_request\",\n \"error_description\": \"The error message description\",\n}\n\nPOST https://www.markate.com/connect/oauth/token
\nAn access token will expire in 7 days while the refresh tokens will never expire.
You can use the refresh token to get a new access token if this is expired or before expiration date.
The POST params
\nclient_id
your app client_id from Markate
client_secret
your app client_secret from Markate
refresh_token
the refresh token
grant_type
refresh_token
{\n \"access_token\":\"028e4c7b3205b5b30afc573658e74613b39c82a6c172041566d46fd47f3dfb5a\",\n \"refresh_token\":\"59fcc38f3d2c961335abb1d16058c06a0df1bf5879ba85397c8af2b8b0880562\",\n \"expires_in\":\"604800\",\n \"expires_on\":\"2021-03-17T13:04:54+00:00\",\n \"token_type\":\"bearer\",\n \"markate_user_id\":\"eR6yNK2wLkZzrkYgEvZz\",\n}\n\nA 400 bad request response is returned with body
\n{\n \"error\": \"invalid_request\",\n \"error_description\": \"The error message description\",\n}\n\nPOST https://www.markate.com/connect/oauth/revoke
\nWill revoke one refresh_token and all access_tokens linked to a refresh_token. Or if you send revoke_all = 1, it will remove all refresh tokens and all access tokens for that user.
\nThe POST params
\nclient_id
your app client_id from Markate
client_secret
your app client_secret from Markate
token
the refresh token
token_hint
refresh_token
revoke_all
optional, set to 1 if you want to remove all refresh tokens and access tokens for the user
{\n \"revoke\":\"true\",\n}\n\nA 400 bad request response is returned with body
\n{\n \"error\": \"invalid_request\",\n \"error_description\": \"The error message description\",\n}\n\nRequest the business object from
\nGET https://www.markate.com/connect/api/v1/business
\n","event":[{"listen":"prerequest","script":{"id":"0ac0a9f0-edf7-4122-9259-3409819b7239","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"b21c8d26-fcfb-48a2-b953-795d3355ba3e","type":"text/javascript","exec":[""]}}],"_postman_id":"24d5e170-755f-406a-a897-502eea7faf49"},{"name":"Authentication","item":[],"id":"582e1ec5-5873-474e-babc-12ae5891b17c","description":"All requests should have the following headers.
\ncurl https://www.markate.com/connect/oauth/token \\\n -X POST \\\n -H 'Markate-Version: 20210301' \\\n -H 'Authorization: Bearer {{access_token}}',\n -H 'Content-Type: application/x-www-form-urlencoded' \\\nMarkate-Version
2021030
For versioning
Authorization
Bearer {{access_token}}
The user access token
Content-Type
application/x-www-form-urlencoded - for all requests
multipart/form-data - for file upload (not available for the moment)
Send a version on the header to get a certain response and keep the API backwards compatible.
\nMarkate-Version: 20240601
\n","event":[{"listen":"prerequest","script":{"id":"cce1ac35-a983-4497-ba79-6869ab1c2c29","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"d0cefa4c-18fa-4bcf-b4a5-4429903c791f","type":"text/javascript","exec":[""]}}],"_postman_id":"bc6651c4-cf61-4fff-81a2-73d808fdd188"},{"name":"Pagination","item":[],"id":"47fb5d29-7991-4779-a887-b49d007d7df3","description":"On some listing endpoints a pagination object is returned. \nIf pagination.next > 0, you can request next page by setting ?page={{pagination.next}}
\n\"pagination\": {\n \"page\": 1,\n \"next\": 2,\n \"previous\": 0,\n \"rows_per_page\": 20,\n \"total_rows\": \"22\",\n \"total_pages\": 2\n}\nBeta
\nTo avoid performing same operation twice you can send an Idempotency-Key header on POST requests. GET and DELETE do not support idempotency.
\nThe key can be a V4 UUID or a random string.
\n -H 'Idempotency-Key: rjreoi343lokd'\nGet the business object.
\n","urlObject":{"path":["connect","api","v1","business"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"d6e8b6eb-98c7-4838-a0d9-07d605155234","name":"Get business","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"url":"{{url}}/connect/api/v1/business"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"business\": {\n \"markate_user_id\": \"eR6yNK2wLkZzrkYgEvZz\",\n \"name\": \"Acme LLC\",\n \"user_name\": \"John Doe\",\n \"locale\": {\n \"country_code\": \"us\",\n \"country_name\": \"United States\",\n \"currency\": \"USD\",\n \"measure_units\": {\n \"distance\": \"mile\",\n \"distance_plural\": \"miles\"\n },\n \"phone_prefix\": 1,\n \"timezones\": {\n \"Pacific/Honolulu\": \"Hawaii Time (UTC -10)\",\n \"America/Adak\": \"Hawaii Daylight Time (UTC -9)\",\n \"America/Anchorage\": \"Alaska Time (UTC -8)\",\n \"America/Los_Angeles\": \"Pacific Time (UTC -7)\",\n \"America/Phoenix\": \"Arizona Time (UTC -7)\",\n \"America/Denver\": \"Mountain Time (UTC -6)\",\n \"America/Chicago\": \"Central Time (UTC -5)\",\n \"America/New_York\": \"Eastern Time (UTC -4)\",\n \"America/St_Thomas\": \"Atlantic Std Time (UTC -4)\"\n }\n }\n }\n}"}],"_postman_id":"dc419561-13a3-46db-b992-61e6e70113b7"}],"id":"2ff228ea-e6b8-4f84-92eb-df5035d87b37","event":[{"listen":"prerequest","script":{"id":"a15ee6d1-d013-469a-97e3-a1cc1806dce5","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"72010bc6-ad60-4a2a-bfcd-01b534fd54b4","type":"text/javascript","exec":[""]}}],"_postman_id":"2ff228ea-e6b8-4f84-92eb-df5035d87b37","description":""},{"name":"Customers","item":[{"name":"List customers","id":"ea473609-aeac-43dd-86b2-05c5fdf41c1b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/customers?type_service=&display_name=&email=&phone=&address=&date_added_or_updated_from=&search=&search_type=fuzzy&order=&page=&rows_per_page=","description":"A list of Customer object
Pagination
int, optional - filter by service type. Values 1 for residendial, 2 for commercial
\n","type":"text/plain"},"key":"type_service","value":""},{"description":{"content":"string, optional - match by display name - exactly or fuzzy
\n","type":"text/plain"},"key":"display_name","value":""},{"description":{"content":"string, optional - match by email - exactly or fuzzy
\n","type":"text/plain"},"key":"email","value":""},{"description":{"content":"string, optional - match by phone - exactly or fuzzy, mininum 4 chars required for fuzzy search
\n","type":"text/plain"},"key":"phone","value":""},{"description":{"content":"string, optional - match by address - exactly or fuzzy
\n","type":"text/plain"},"key":"address","value":""},{"description":{"content":"string, optional - get records added or update starting from date, the date can not be older than 30 days, sample format 2024-11-15
\n","type":"text/plain"},"key":"date_added_or_updated_from","value":""},{"description":{"content":"string, optional - search multiple fields: display_name, first & last name, email, phone, address, company
\n","type":"text/plain"},"key":"search","value":""},{"description":{"content":"string, optional - empty for exact match or fuzzy for fuzzy search (applied to only one field, eg display_name)
\n","type":"text/plain"},"key":"search_type","value":"fuzzy"},{"description":{"content":"string, optional - default: name-asc, allowed values: name-asc, name-desc, last-name-asc, last-name-desc, email-asc, email-desc
\n","type":"text/plain"},"key":"order","value":""},{"description":{"content":"int, optional - default: 20
\n","type":"text/plain"},"key":"page","value":""},{"description":{"content":"int, optional - default: 1
\n","type":"text/plain"},"key":"rows_per_page","value":""}],"variable":[]}},"response":[{"id":"c7124376-68f9-4970-827b-063faf5ad7c0","name":"List customers","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":{"raw":"{{url}}/connect/api/v1/customers?type_service=&display_name=&email=&phone=&search=&order=&page&rows_per_page","host":["{{url}}"],"path":["connect","api","v1","customers"],"query":[{"key":"type_service","value":"","description":"filter by service type. Values 1 for residendial, 2 for commercial"},{"key":"display_name","value":"","description":"match by display name exactly"},{"key":"email","value":"","description":"match by email exactly"},{"key":"phone","value":"","description":"match by phone exactly"},{"key":"search","value":"","description":"search multiple fields: display_name, first & last name, email, phone, address, company"},{"key":"order","value":"","description":"default: name-asc, allowed values: name-asc, name-desc, last-name-asc, last-name-desc, email-asc, email-desc"},{"key":"page","value":null,"description":"default: 20"},{"key":"rows_per_page","value":null,"description":"page\ndefault: 1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"customers\": [\n {\n \"id\": \"19321\",\n \"display_name\": \"John Doe\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"company\": \"Acme Inc\",\n \"email\": \"johndoe@test.com\",\n \"phone\": \"2123334444\",\n \"phone_secondary\": \"5556667777\",\n \"address\": \"300 North Los Angeles Street\",\n \"address_secondary\": \"Suite 10\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90012\",\n \"latlng\": \"34.0539775,-118.240053\",\n \"notes\": \"Needs carpet cleaning\",\n \"notify_method_email\": \"1\",\n \"notify_method_sms\": \"1\",\n \"type_service\": \"1\",\n \"type_service_text\": \"Residential\",\n \"datetime_added\": \"2021-03-10T14:00:14+00:00\",\n \"datetime_updated\": null\n },\n ],\n \"pagination\": {\n \"page\": 1,\n \"next\": 2,\n \"previous\": 0,\n \"rows_per_page\": 20,\n \"total_rows\": \"108\",\n \"total_pages\": 6\n }\n}"}],"_postman_id":"ea473609-aeac-43dd-86b2-05c5fdf41c1b"},{"name":"Get customer","id":"2dc110dd-01d4-445f-84af-84999de69ff2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/customers/33855","urlObject":{"path":["connect","api","v1","customers","33855"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"b9ff4592-0482-459b-9c92-9992aafaae13","name":"Get customer","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/customers/19321"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"customer\": {\n \"id\": \"19321\",\n \"display_name\": \"John Doe\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"company\": \"Acme Inc\",\n \"email\": \"johndoe@test.com\",\n \"phone\": \"2123334444\",\n \"phone_secondary\": \"5556667777\",\n \"address\": \"300 North Los Angeles Street\",\n \"address_secondary\": \"Suite 10\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90012\",\n \"latlng\": \"34.0539775,-118.240053\",\n \"notes\": \"Needs carpet cleaning\",\n \"notify_method_email\": \"1\",\n \"notify_method_sms\": \"1\",\n \"type_service\": \"1\",\n \"type_service_text\": \"Residential\",\n \"datetime_added\": \"2021-03-10T14:00:14+00:00\",\n \"datetime_updated\": null\n }\n}"}],"_postman_id":"2dc110dd-01d4-445f-84af-84999de69ff2"},{"name":"Create customer","id":"a83380f9-6354-48cb-ad59-ca2721d8d7ab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type_service","value":"1","type":"text","description":"int, required - Customer service type, allowed values: 1 for residential customers, 2 for commercial customers
\n"},{"key":"first_name","value":"Jessica","type":"text","description":"string, conditionally required - At least first name or last name has to be provided
\n"},{"key":"last_name","value":"Tucker","type":"text","description":"string, conditionally required - At least first name or last name has to be provided
\n"},{"key":"company","value":"Acme Inc","type":"text","description":"string, conditionally required - Required if type_service = 2 (commercial), optional if type_service = 1
\n"},{"key":"email","value":"jessicamwill777@gmail.com","type":"text","description":"string, optional
\n"},{"key":"phone","value":"2123334444","type":"text","description":"string, optional - Mobile phone to send SMS/Text alerts to customer
\n"},{"key":"phone_secondary","value":"5556667777","type":"text","description":"string, optional - Other phone number, e.g. landline
\n"},{"key":"address","value":"300 North Los Angeles Street","type":"text","description":"string, optional - Street address
\n"},{"key":"address_secondary","value":"Suite 10","type":"text","description":"string, optional - For suite/unit or apartment, building, floor, PO Box
\n"},{"key":"city","value":"Los Angeles","type":"text","description":"string, optional
\n"},{"key":"zip","value":"90012","type":"text","description":"string, optional
\n"},{"key":"state","value":"CA","type":"text","description":"string, optional
\n"},{"key":"notes","value":"Needs carpet cleaning","type":"text","description":"string, optional - Some internal notes not visible to customer
\n"}]},"url":"{{url}}/connect/api/v1/customers","urlObject":{"path":["connect","api","v1","customers"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"20f41f76-5ed5-4503-9c75-f158771aa388","name":"Create customer","originalRequest":{"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type_service","value":"1","type":"text","description":"int, required - Customer service type, allowed values: 1 for residential customers, 2 for commercial customers"},{"key":"first_name","value":"John","type":"text","description":"string, conditionally required - At least first name or last name has to be provided"},{"key":"last_name","value":"Doe","type":"text","description":"string, conditionally required - At least first name or last name has to be provided"},{"key":"company","value":"Acme Inc","type":"text","description":"string, optional - If type_service = 1 and required if type_service = 2"},{"key":"email","value":"johndoe@test.com","type":"text","description":"string, optional"},{"key":"phone","value":"2123334444","type":"text","description":"string, optional - Mobile phone to send SMS/Text alerts to customer"},{"key":"phone_secondary","value":"5556667777","type":"text","description":"string, optional - Other phone number, e.g. landline"},{"key":"address","value":"300 North Los Angeles Street","type":"text","description":"string, optional - Street address"},{"key":"address_secondary","value":"Suite 10","type":"text","description":"string, optional - For suite/unit or apartment, building, floor, PO Box"},{"key":"city","value":"Los Angeles","type":"text","description":"string, optional"},{"key":"zip","value":"90012","type":"text","description":"string, optional"},{"key":"state","value":"CA","type":"text","description":"string, optional"},{"key":"notes","value":"Needs carpet cleaning","type":"text","description":"string, optional - Some internal notes not visible to customer"}]},"url":"{{url}}/connect/api/v1/customers"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"customer\": {\n \"id\": \"19321\",\n \"display_name\": \"John Doe\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"company\": \"Acme Inc\",\n \"email\": \"johndoe@test.com\",\n \"phone\": \"2123334444\",\n \"phone_secondary\": \"5556667777\",\n \"address\": \"300 North Los Angeles Street\",\n \"address_secondary\": \"Suite 10\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90012\",\n \"latlng\": \"34.0539775,-118.240053\",\n \"notes\": \"Needs carpet cleaning\",\n \"notify_method_email\": \"1\",\n \"notify_method_sms\": \"1\",\n \"type_service\": \"1\",\n \"type_service_text\": \"Residential\",\n \"datetime_added\": \"2021-03-10T14:00:14+00:00\",\n \"datetime_updated\": null\n }\n}"}],"_postman_id":"a83380f9-6354-48cb-ad59-ca2721d8d7ab"},{"name":"Update customer","id":"889020b3-9b59-4703-b7a8-8893c8212fbd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type_service","value":"2","type":"text","disabled":true},{"key":"first_name","value":"John A","type":"text"},{"key":"last_name","value":"Doe B","type":"text"},{"key":"company","value":"The cleaning Company","type":"text","disabled":true},{"key":"email","value":"johndoe@test.com","type":"text","disabled":true},{"key":"phone","value":"2123334444","type":"text","disabled":true},{"key":"phone_secondary","value":"5556667777","type":"text","disabled":true},{"key":"address","value":"300 North Los Angeles Street","type":"text","disabled":true},{"key":"address_secondary","value":"Suite 10","type":"text","disabled":true},{"key":"city","value":"Los Angeles","type":"text","disabled":true},{"key":"zip","value":"90012","type":"text","disabled":true},{"key":"state","value":"CA","type":"text","disabled":true},{"key":"notes","value":"Needs carpet cleaning","type":"text","disabled":true}]},"url":"{{url}}/connect/api/v1/customers/62797","description":"You can use a sparse object to update fields or full object.
\n","urlObject":{"path":["connect","api","v1","customers","62797"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"889020b3-9b59-4703-b7a8-8893c8212fbd"},{"name":"Delete customer","id":"c7c97b6e-8572-4620-a4db-e6c8965f3a87","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/customers/73442","urlObject":{"path":["connect","api","v1","customers","73442"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"806834f4-6617-4b7e-b8c1-aae6398b0512","name":"Delete customer","originalRequest":{"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/customers/19337"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"delete\": true,\n \"id\": \"19337\"\n}"}],"_postman_id":"c7c97b6e-8572-4620-a4db-e6c8965f3a87"}],"id":"2562488b-09a0-49aa-bcc8-53290d127287","_postman_id":"2562488b-09a0-49aa-bcc8-53290d127287","description":""},{"name":"Customer Addresses","item":[{"name":"List all addresses","id":"fa6302ba-5909-4ffe-a852-68ac02dd6d90","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/customer/addresses?customer_id=33855&search=&order=&page=&rows_per_page=","description":"A list of addresses for a customer.
Pagination
int, required
\n","type":"text/plain"},"key":"customer_id","value":"33855"},{"description":{"content":"string, optional - Search multiple fields
\n","type":"text/plain"},"key":"search","value":""},{"description":{"content":"string, optional - Default address-asc, allowed values: address-asc, address-desc, name-asc, name-desc
\n","type":"text/plain"},"key":"order","value":""},{"description":{"content":"default: 20
\n","type":"text/plain"},"key":"page","value":""},{"description":{"content":"default: 1
\n","type":"text/plain"},"key":"rows_per_page","value":""}],"variable":[]}},"response":[{"id":"4954995f-f901-4334-bf28-a27ed1002ce4","name":"List all addresses","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":{"raw":"{{url}}/connect/api/v1/customer/addresses?customer_id=33855&search=&order=","host":["{{url}}"],"path":["connect","api","v1","customer","addresses"],"query":[{"key":"customer_id","value":"33855","description":"int, required"},{"key":"search","value":"","description":"string, optional - Search multiple fields"},{"key":"order","value":"","description":"string, optional - Default address-asc, allowed values: address-asc, address-desc, name-asc, name-desc"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 08 Aug 2024 14:23:59 GMT"},{"key":"Server","value":"Apache/2.4.25 (Unix) LibreSSL/2.2.7 PHP/7.4.30"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:8080"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"X-Powered-By","value":"PHP/7.4.30"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"customer_addresses\": [\n {\n \"id\": -1,\n \"customer_id\": \"33855\",\n \"address\": \"3900 Elati Street\",\n \"address_secondary\": \"A123\",\n \"address_notes\": \"1234#\",\n \"city\": \"Denver\",\n \"state\": \"CO\",\n \"zip\": \"80216\",\n \"latlng\": \"39.7712523,-104.9925898\",\n \"address_full\": \"3900 Elati Street, A123, Denver, CO, 80216\",\n \"first_name\": \"Aby\",\n \"last_name\": \"Turners\",\n \"name\": \"Aby Turners\",\n \"email\": \"abyturner@test.com\",\n \"phone\": \"4803601360\",\n \"phone_prefix\": \"1\",\n \"phone_intl\": \"14803601360\",\n \"notes\": null,\n \"datetime_added\": null,\n \"datetime_updated\": null\n },\n {\n \"id\": \"2492\",\n \"customer_id\": \"33855\",\n \"address\": \"300 North Los Angeles Street\",\n \"address_secondary\": \"\",\n \"address_notes\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"zip\": \"\",\n \"latlng\": \"34.0537012,-118.23977\",\n \"address_full\": \"300 North Los Angeles Street\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"name\": \"\",\n \"email\": \"\",\n \"phone\": \"0\",\n \"phone_prefix\": null,\n \"phone_intl\": null,\n \"notes\": \"aaa\",\n \"datetime_added\": \"2024-05-22T08:03:37+00:00\",\n \"datetime_updated\": \"2024-07-31T13:10:47+00:00\"\n },\n ]\n}"}],"_postman_id":"fa6302ba-5909-4ffe-a852-68ac02dd6d90"},{"name":"Get address","id":"ff9ac5c5-087d-454c-b943-20f1b3a43eeb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/customer/addresses/2492","urlObject":{"path":["connect","api","v1","customer","addresses","2492"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"b5aa3c07-3484-4027-9458-866136b2be3a","name":"Get address","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/customer/addresses/703"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 30 May 2024 13:00:08 GMT"},{"key":"Server","value":"Apache/2.4.38 (Debian)"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"Content-Length","value":"573"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"customer_address\": {\n \"id\": \"703\",\n \"customer_id\": \"58645\",\n \"address\": \"300 North Los Angeles Street\",\n \"address_secondary\": \"Suite 10\",\n \"address_notes\": \"#4422\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90012\",\n \"latlng\": \"12.233434,134.43434\",\n \"address_full\": \"300 North Los Angeles Street, Suite 10, Los Angeles, CA, 90012\",\n \"first_name\": \"Jessica\",\n \"last_name\": \"Turner\",\n \"name\": \"Jessica Turner\",\n \"email\": \"jessica@test.com\",\n \"phone\": \"2123334444\",\n \"phone_prefix\": \"1\",\n \"phone_intl\": \"12123334444\",\n \"notes\": \"Needs carpet cleaning\",\n \"datetime_added\": \"2024-05-30T04:30:41+00:00\",\n \"datetime_updated\": null\n }\n}"}],"_postman_id":"ff9ac5c5-087d-454c-b943-20f1b3a43eeb"},{"name":"Create address","id":"cef36e06-0e9c-446d-bd8c-4b64b9813857","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"customer_id","value":"14429","type":"text","description":"int, required - The ID of the customer
\n"},{"key":"address","value":"300 North Los Angeles Street","type":"text","description":"string, required - Street address
\n"},{"key":"address_secondary","value":"Suite 10","type":"text","description":"string, optional - Suite/Unit
\n"},{"key":"address_notes","value":"#4422","type":"text","description":"string, optional - Access Code (e.g. gate code, door or lockbox code)
\n"},{"key":"city","value":"Los Angeles","type":"text","description":"string, optional
\n"},{"key":"zip","value":"90012","type":"text","description":"string, optional
\n"},{"key":"state","value":"CA","type":"text","description":"string, optional
\n"},{"key":"latlng","value":"12.233434,134.43434","type":"text","description":"string, optional
\n"},{"key":"name","value":"Jessica Turner","type":"text","description":"string, optional - Contact Name (e.g. tenant or occupant name)
\n"},{"key":"email","value":"jessica@test.com","type":"text","description":"string, optional
\n"},{"key":"phone","value":"2123334444","type":"text","description":"string, optional
\n"},{"key":"notes","value":"Needs carpet cleaning","type":"text","description":"string, optional - Some internal notes
\n"}]},"url":"{{url}}/connect/api/v1/customer/addresses","urlObject":{"path":["connect","api","v1","customer","addresses"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"cef36e06-0e9c-446d-bd8c-4b64b9813857"},{"name":"Update address","id":"021f10e7-3f2a-4058-86a3-1f3af7df0d2c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"address","value":"300 North Los Angeles Street","type":"text","description":"string, required - Street address
\n"},{"key":"address_secondary","value":"Suite 10","type":"text","description":"string, optional - Suite/Unit
\n"},{"key":"address_notes","value":"#4422","type":"text","description":"string, optional - Access Code (e.g. gate code, door or lockbox code)
\n"},{"key":"city","value":"Los Angeles","type":"text","description":"string, optional
\n"},{"key":"zip","value":"90012","type":"text","description":"string, optional
\n"},{"key":"state","value":"CA","type":"text","description":"string, optional
\n"},{"key":"latlng","value":"12.233434,134.43434","type":"text","description":"string, optional
\n"},{"key":"name","value":"Jessica Turner","type":"text","description":"string, optional - Contact Name (e.g. tenant or occupant name)
\n"},{"key":"email","value":"jessicaturner@test.com","type":"text","description":"string, optional
\n"},{"key":"phone","value":"2123334444","type":"text","description":"string, optional
\n"},{"key":"notes","value":"Needs carpet cleaning","type":"text","description":"string, optional - Some internal notes
\n"}]},"url":"{{url}}/connect/api/v1/customer/addresses/2506","urlObject":{"path":["connect","api","v1","customer","addresses","2506"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"021f10e7-3f2a-4058-86a3-1f3af7df0d2c"},{"name":"Delete address","id":"d71e47c6-b11f-4d7a-bcc8-870143c43fc9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/customer/addresses/2506","urlObject":{"path":["connect","api","v1","customer","addresses","2506"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"d71e47c6-b11f-4d7a-bcc8-870143c43fc9"}],"id":"eca28deb-e21c-4226-8cfa-20824e8a2236","_postman_id":"eca28deb-e21c-4226-8cfa-20824e8a2236","description":""},{"name":"Customer Sources","item":[{"name":"List all customer sources","id":"4be0c29e-07aa-4e90-9681-b8f4a108af76","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/customer/sources?page=&rows_per_page=","description":"A list of customer sources.
Pagination
default: 1
\n","type":"text/plain"},"key":"page","value":""},{"description":{"content":"default: 20
\n","type":"text/plain"},"key":"rows_per_page","value":""}],"variable":[]}},"response":[{"id":"bb10faa2-39bf-4dec-85f4-7a0d7548d1eb","name":"List all sources","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":{"raw":"{{url}}/connect/api/v1/customer/sources?page=&rows_per_page=","host":["{{url}}"],"path":["connect","api","v1","customer","sources"],"query":[{"key":"page","value":"","description":"default: 1"},{"key":"rows_per_page","value":"","description":"default: 20"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 08 Aug 2024 15:25:20 GMT"},{"key":"Server","value":"Apache/2.4.25 (Unix) LibreSSL/2.2.7 PHP/7.4.30"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:8080"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"X-Powered-By","value":"PHP/7.4.30"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"customer_sources\": [ \n {\n \"id\": \"3925\",\n \"name\": \"Ads\",\n \"datetime_added\": \"2019-02-02T01:16:40+00:00\",\n \"datetime_updated\": \"2023-04-24T19:21:21+00:00\"\n }, \n {\n \"id\": \"3756\",\n \"name\": \"Facebook\",\n \"datetime_added\": \"2018-04-09T23:42:18+00:00\",\n \"datetime_updated\": \"2019-01-28T19:01:40+00:00\"\n },\n {\n \"id\": \"3813\",\n \"name\": \"Friend\",\n \"datetime_added\": \"2018-08-10T20:48:18+00:00\",\n \"datetime_updated\": null\n }, \n ],\n \"paginator\": {\n \"page\": 1,\n \"next\": 2,\n \"previous\": 0,\n \"page_has_rows\": true,\n \"rows_per_page\": 20,\n \"total_rows\": \"26\",\n \"total_pages\": 2\n }\n}"}],"_postman_id":"4be0c29e-07aa-4e90-9681-b8f4a108af76"},{"name":"Get customer source","id":"b5a0b42c-a11f-4e06-aaab-704072d01946","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/customer/sources/3756","urlObject":{"path":["connect","api","v1","customer","sources","3756"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"df807f2b-303a-4cb6-9a2f-55a6376768b6","name":"Get customer source","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/customer/sources/3756"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Tue, 25 Nov 2025 15:01:24 GMT"},{"key":"Server","value":"Apache/2.4.62 (Debian)"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"X-Powered-By","value":"PHP/7.4.33"},{"key":"Content-Length","value":"143"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"customer_source\": {\n \"id\": \"3756\",\n \"name\": \"Facebook\",\n \"datetime_added\": \"2018-04-09T23:42:18+00:00\",\n \"datetime_updated\": \"2019-01-28T19:01:40+00:00\"\n }\n}"}],"_postman_id":"b5a0b42c-a11f-4e06-aaab-704072d01946"},{"name":"Create customer source","id":"23f70c1a-45a5-410a-9e6d-3b1a16a3e53a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"name","value":"Facebook","type":"text","description":"string, required
\n"}]},"url":"{{url}}/connect/api/v1/customer/sources","urlObject":{"path":["connect","api","v1","customer","sources"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"23f70c1a-45a5-410a-9e6d-3b1a16a3e53a"},{"name":"Update customer source","id":"825e84fa-87e4-4f6b-8e62-8cbc5fad3472","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"name","value":"Facebook","type":"text","description":"string, required
\n"}]},"url":"{{url}}/connect/api/v1/customer/sources/5361","urlObject":{"path":["connect","api","v1","customer","sources","5361"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"825e84fa-87e4-4f6b-8e62-8cbc5fad3472"},{"name":"Delete customer source","id":"2ddf2484-a194-4e09-978b-1fae293b0d06","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/customer/sources/5363","urlObject":{"path":["connect","api","v1","customer","sources","5363"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"2ddf2484-a194-4e09-978b-1fae293b0d06"}],"id":"6798a291-bb37-4544-89a4-75e62924bd75","_postman_id":"6798a291-bb37-4544-89a4-75e62924bd75","description":""},{"name":"Employees","item":[{"name":"List employees","id":"14da3488-564d-4122-821d-10491e33e272","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/employees?search=&order=&page=&rows_per_page=","description":"A list of Employee object
Pagination
search multiple fields
\n","type":"text/plain"},"key":"search","value":""},{"description":{"content":"default: name-asc, allowed values: name-asc, name-desc, email-asc, email-desc
\n","type":"text/plain"},"key":"order","value":""},{"description":{"content":"default: 20
\n","type":"text/plain"},"key":"page","value":""},{"description":{"content":"default: 1
\n","type":"text/plain"},"key":"rows_per_page","value":""}],"variable":[]}},"response":[{"id":"22282b52-fb2b-4a2b-84d7-10047ee938d8","name":"List employees","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":{"raw":"{{url}}/connect/api/v1/employees?search=&order=&page=&rows_per_page=","host":["{{url}}"],"path":["connect","api","v1","employees"],"query":[{"key":"search","value":"","description":"search multiple fields"},{"key":"order","value":"","description":"default: name-asc, allowed values: name-asc, name-desc, email-asc, email-desc"},{"key":"page","value":"","description":"default: 20"},{"key":"rows_per_page","value":"","description":"default: 1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 29 Jun 2021 19:28:40 GMT"},{"key":"Server","value":"Apache/2.4.25 (Unix) LibreSSL/2.2.7 PHP/5.6.27"},{"key":"X-Powered-By","value":"PHP/5.6.27"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"employees\": [\n {\n \"id\": \"386\",\n \"is_owner\": false,\n \"first_name\": \"Dany\",\n \"last_name\": \"Howard\",\n \"phone\": \"1234445555\",\n \"email\": \"dany@test.com\",\n \"about\": \"\",\n \"image_avatar\": {\n \"url_or\": \"https://www.markate.com/employee_386_ce7e90eeb3_or.jpg\",\n \"url_sm\": \"https://www.markate.com/employee_386_ce7e90eeb3_sm.jpg\"\n },\n \"datetime_added\": \"2018-06-11T20:36:18+00:00\",\n \"datetime_updated\": \"2021-06-16T21:08:57+00:00\"\n },\n ],\n \"pagination\": {\n \"page\": 1,\n \"next\": 2,\n \"previous\": 0,\n \"rows_per_page\": 20,\n \"total_rows\": \"21\",\n \"total_pages\": 2\n }\n}"}],"_postman_id":"14da3488-564d-4122-821d-10491e33e272"},{"name":"Get employee","id":"2102e1c8-bec1-4830-95d1-fd4a469b187f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/employees/601","urlObject":{"path":["connect","api","v1","employees","601"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"3bb52676-d3e9-4d78-82a4-7cc5aeb0dde1","name":"Get employee","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/employees/386"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 29 Jun 2021 19:30:11 GMT"},{"key":"Server","value":"Apache/2.4.25 (Unix) LibreSSL/2.2.7 PHP/5.6.27"},{"key":"X-Powered-By","value":"PHP/5.6.27"},{"key":"Content-Length","value":"412"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"employee\": {\n \"id\": \"386\",\n \"is_owner\": false,\n \"first_name\": \"Dany\",\n \"last_name\": \"Howard\",\n \"phone\": \"1234445555\",\n \"email\": \"dany@u-zine.com\",\n \"about\": \"\",\n \"image_avatar\": {\n \"url_or\": \"https://markate.test/cdn/20180625/employee_386_ce7e90eeb3_or.jpg\",\n \"url_sm\": \"https://markate.test/cdn/20180625/employee_386_ce7e90eeb3_sm.jpg\"\n },\n \"datetime_added\": \"2018-06-11T20:36:18+00:00\",\n \"datetime_updated\": \"2021-06-16T21:08:57+00:00\"\n }\n}"}],"_postman_id":"2102e1c8-bec1-4830-95d1-fd4a469b187f"}],"id":"afd7d17d-e667-4cb6-918f-348569b598ae","event":[{"listen":"prerequest","script":{"id":"9f3902e3-ba62-4291-9a8e-721455c6e32f","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"7431b48f-34e6-46d0-a5a2-dfd64bd78674","type":"text/javascript","exec":[""]}}],"_postman_id":"afd7d17d-e667-4cb6-918f-348569b598ae","description":""},{"name":"Estimates","item":[{"name":"List estimates","id":"daa9ec6e-3a1f-4423-9f2d-edba30401617","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/estimates?customer_id=&status=&search=&order=&page=&rows_per_page=","description":"A list of Estimate object
Pagination
int, optional - List all estimates for a customer
\n","type":"text/plain"},"key":"customer_id","value":""},{"description":{"content":"string, optional - Filter by status, use a letter for each status: Submitted S, Accepted A, Lost L, Declined by customer X, Invoiced V, Inactive P, Draft D
\n","type":"text/plain"},"key":"status","value":""},{"description":{"content":"string, optional - Search in multiple fields
\n","type":"text/plain"},"key":"search","value":""},{"description":{"content":"int, optional - Allowed values: added-asc, added-desc, date-accepted-asc, date-accepted-desc, number-asc, number-desc, amount-asc, amount-desc
\n","type":"text/plain"},"key":"order","value":""},{"key":"page","value":""},{"description":{"content":"int, optional - Default 20
\n","type":"text/plain"},"key":"rows_per_page","value":""}],"variable":[]}},"response":[],"_postman_id":"daa9ec6e-3a1f-4423-9f2d-edba30401617"},{"name":"Get estimate","id":"2a23edb5-b974-412b-b780-790c3fbe8677","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/estimates/8299","urlObject":{"path":["connect","api","v1","estimates","8299"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"9a7049c4-ad71-4b82-bbf6-430264a5e5df","name":"Get estimate","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/estimates/8299"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 13 Oct 2025 13:41:37 GMT"},{"key":"Server","value":"Apache/2.4.62 (Debian)"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"X-Powered-By","value":"PHP/7.4.33"},{"key":"Content-Length","value":"1521"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"estimate\": {\n \"id\": \"8299\",\n \"type\": \"1\",\n \"type_normal\": true,\n \"type_options\": false,\n \"type_packages\": false,\n \"customer_id\": \"74068\",\n \"customer\": {\n \"id\": \"74068\",\n \"name\": \"Jack Riserside\"\n },\n \"customer_address_id\": \"-1\",\n \"lead_id\": \"719\",\n \"item_list_type\": \"1\",\n \"quantity_type\": 0,\n \"quantity_type_text\": \"Qty\",\n \"custom_number\": \"EST-01204\",\n \"purchase_order_number\": \"PO-148309\",\n \"date_issued\": \"2025-10-20 00:00:00\",\n \"date_issued_text\": \"20-Oct-2025\",\n \"date_expire\": \"2025-10-27 00:00:00\",\n \"date_expire_text\": \"27-Oct-2025\",\n \"subtotal\": \"100.00\",\n \"subtotal_text\": \"$100.00\",\n \"adjustment_name\": \"Extra fee\",\n \"adjustment_type\": \"1\",\n \"adjustment_total\": \"2.00\",\n \"adjustment_total_text\": \"$2.00\",\n \"adjustment_percent\": \"2.00\",\n \"total\": \"102.00\",\n \"total_text\": \"$102.00\",\n \"deposit_type\": \"1\",\n \"deposit_amount\": \"10.00\",\n \"deposit_amount_text\": \"$10.00\",\n \"deposit_percent\": \"9.80\",\n \"message\": \"message\",\n \"terms\": \"terms\",\n \"notes\": \"some notes\",\n \"viewed\": 0,\n \"viewed_datetime\": null,\n \"viewed_text\": \"\",\n \"status\": \"D\",\n \"status_text\": \"Draft\",\n \"datetime_added\": \"2025-10-20T00:00:00+00:00\",\n \"datetime_updated\": null,\n \"items\": [\n {\n \"id\": \"10196\",\n \"type\": \"1\",\n \"type_text\": \"Service\",\n \"name\": \"Cleaning\",\n \"description\": \"\",\n \"qty\": \"1.00\",\n \"price\": \"100.00\",\n \"discount_type\": \"1\",\n \"discount_percent\": \"0.00\",\n \"discount_amount\": \"0.00\",\n \"tax_percent\": 0,\n \"tax_amount\": \"0.00\",\n \"tax_rate_id\": \"0\",\n \"total\": \"100.00\",\n \"image\": {\n \"name\": null,\n \"name_hash\": null,\n \"url_or\": \"https://markate.test/assets/images/app/pro/estimates/items/nopic_sm.jpg\",\n \"url_sm\": \"https://markate.test/assets/images/app/pro/estimates/items/nopic_sm.jpg\"\n },\n \"position\": \"0\"\n }\n ]\n }\n}"}],"_postman_id":"2a23edb5-b974-412b-b780-790c3fbe8677"},{"name":"Get estimates config","id":"e3b4f093-8f92-4c64-b41c-d82f85e287d9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/estimates/config","urlObject":{"path":["connect","api","v1","estimates","config"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"e62f8a1a-8802-4c76-aed3-e6c69a1f3452","name":"Get estimates config","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/estimates/config"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Fri, 10 Oct 2025 14:03:22 GMT"},{"key":"Server","value":"Apache/2.4.62 (Debian)"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"X-Powered-By","value":"PHP/7.4.33"},{"key":"Content-Length","value":"1208"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"estimate_config\": {\n \"next_custom_number\": [\n \"EST-\",\n \"009567\"\n ],\n \"date_expire_period\": \"2\",\n \"message\": \"estimate message residential\",\n \"message_commercial\": \"estimate message commercial\",\n \"terms\": \"estimate terms residential\",\n \"terms_commercial\": \"estimate message commercial\",\n \"options_selected_default\": \"2\"\n },\n \"estimate_empty\": {\n \"type\": 1,\n \"type_text\": \"Standard\",\n \"type_normal\": true,\n \"type_options\": false,\n \"type_packages\": false,\n \"custom_job_title\": \"\",\n \"custom_number\": \"EST-009567\",\n \"date_expire\": \"2025-10-24\",\n \"date_expire_text\": \"24-Oct-2025\",\n \"date_added\": \"2025-10-10\",\n \"date_added_text\": \"10-Oct-2025\",\n \"date_added_text_passed\": \"Today\",\n \"item_list_type\": 1,\n \"subtotal\": 0,\n \"adjustment_name\": \"\",\n \"adjustment_total\": 0,\n \"adjustment_type\": 1,\n \"adjustment_percent\": 0,\n \"total\": 0,\n \"deposit_type\": 1,\n \"deposit_amount\": 0,\n \"deposit_percent\": 0,\n \"message\": \"estimate message residential\",\n \"terms\": \"estimate terms residential\",\n \"notes\": \"\",\n \"status\": \"D\",\n \"status_text\": \"Draft\"\n },\n \"estimate_type\": {\n \"1\": \"Standard\",\n \"2\": \"Options\",\n \"3\": \"Packages\"\n },\n \"item_type\": {\n \"1\": \"Service\",\n \"2\": \"Material\",\n \"3\": \"Product\"\n },\n \"quantity_types\": {\n \"0\": \"Qty\",\n \"1\": \"Hours\",\n \"2\": \"Sq ft\",\n \"3\": \"Rooms\",\n \"4\": \"Lin ft\"\n },\n \"tax_rate_default\": {\n \"id\": \"39\",\n \"name\": \"Local Tax\",\n \"rate\": 13,\n \"rate_text\": \"13%\",\n \"is_default\": \"1\"\n }\n}"}],"_postman_id":"e3b4f093-8f92-4c64-b41c-d82f85e287d9"},{"name":"Create standard estimate","id":"072d6a19-2c20-4869-9565-a7914c610f88","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"1","type":"text","description":"int, required - allowed values 1 for standard estimate
\n"},{"key":"customer_id","value":"62655","type":"text","description":"int, required - the customer to set on estimate
\n"},{"key":"customer_address_id","value":"-1","type":"text","description":"int, optional - If -1 will set the location as customer location, else if > 0 a valid customer_address_id is required
\n"},{"key":"custom_number","value":"EST-01204","type":"text","description":"string, conditionally required - On create if empty the system will auto-generate next number, also you can use invoices/config endpoint to get the next number, or set your own number
\n"},{"key":"custom_job_title","value":"Cleaning Job","type":"text","description":"string, optional
\n"},{"key":"purchase_order_number","value":"PO-148309","type":"text","description":"string, optional
\n"},{"key":"date_issued","value":"2025-10-20","type":"text","description":"string, optional
\n"},{"key":"date_expire","value":"2025-10-27","type":"text","description":"string, required
\n"},{"key":"item_list_type","value":"1","type":"text","description":"int, required - set 1 to set an tems list and 2 for item summary (one item)
\n"},{"key":"quantity_type","value":"","type":"text"},{"key":"adjustment_name","value":"Extra fee","type":"text"},{"key":"adjustment_type","value":"1","type":"text"},{"key":"adjustment_total","value":"2","type":"text"},{"key":"adjustment_percent","value":"","type":"text"},{"key":"message","value":"message","type":"text"},{"key":"terms","value":"terms","type":"text"},{"key":"notes","value":"some notes","type":"text"},{"key":"deposit_type","value":"1","type":"text","description":"int, optional - set to 1 for amount deposit and 2 for percentage deposit
\n"},{"key":"deposit_amount","value":"10","type":"text","description":"float, optional conditional if deposit_type = 1
\n"},{"key":"deposit_percent","value":"","type":"text","description":"float, optional conditional if deposit_type = 2
\n"},{"key":"items[0][id]","value":"0","type":"text"},{"key":"items[0][type]","value":"1","type":"text"},{"key":"items[0][name]","value":"Cleaning","type":"text"},{"key":"items[0][description]","value":"","type":"text"},{"key":"items[0][price]","value":"100","type":"text"},{"key":"items[0][qty]","value":"1","type":"text"},{"key":"items[0][tax_percent]","value":"","type":"text"},{"key":"items[0][tax_rate_id]","value":"","type":"text"},{"key":"items[0][discount_type]","value":"1","type":"text"},{"key":"items[0][discount_amount]","value":"","type":"text"},{"key":"items[0][discount_percent]","value":"","type":"text","description":"int, conditional only for type =3 package estimate, mark the primary package
\n"}]},"url":"{{url}}/connect/api/v1/estimates","urlObject":{"path":["connect","api","v1","estimates"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"072d6a19-2c20-4869-9565-a7914c610f88"},{"name":"Create options estimate","id":"6e7be4bd-4055-4dca-9034-dcf09bd619c7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"2","type":"text","description":"int, required - 2 for options estimate
\n"},{"key":"customer_id","value":"14429","type":"text","description":"int, required - the customer to set on estimate
\n"},{"key":"customer_address_id","value":"-1","type":"text","description":"int, optional - If -1 will set the location as customer location, else if > 0 a valid customer_address_id is required
\n"},{"key":"custom_number","value":"EST-01204","type":"text","description":"string, conditionally required - On create if empty the system will auto-generate next number, also you can use invoices/config endpoint to get the next number, or set your own number
\n"},{"key":"custom_job_title","value":"Cleaning Job","type":"text","description":"string, optional
\n"},{"key":"purchase_order_number","value":"PO-148309","type":"text","description":"string, optional
\n"},{"key":"date_issued","value":"2025-10-20","type":"text","description":"string, optional
\n"},{"key":"date_expire","value":"2025-10-27","type":"text","description":"string, required
\n"},{"key":"item_list_type","value":"1","type":"text","description":"int, required - set 1 to set an tems list and 2 for item summary (one item)
\n"},{"key":"quantity_type","value":"","type":"text"},{"key":"adjustment_name","value":"Extra fee","type":"text"},{"key":"adjustment_type","value":"1","type":"text"},{"key":"adjustment_total","value":"2","type":"text"},{"key":"adjustment_percent","value":"","type":"text"},{"key":"message","value":"message","type":"text"},{"key":"terms","value":"terms","type":"text"},{"key":"notes","value":"some notes","type":"text"},{"key":"deposit_type","value":"1","type":"text","description":"int, optional - set to 1 for amount deposit and 2 for percentage deposit
\n"},{"key":"deposit_amount","value":"10","type":"text","description":"float, optional conditional if deposit_type = 1
\n"},{"key":"deposit_percent","value":"","type":"text","description":"float, optional conditional if deposit_type = 2
\n"},{"key":"items[0][id]","value":"0","type":"text"},{"key":"items[0][type]","value":"1","type":"text"},{"key":"items[0][name]","value":"Cleaning","type":"text"},{"key":"items[0][description]","value":"","type":"text"},{"key":"items[0][price]","value":"100","type":"text"},{"key":"items[0][qty]","value":"1","type":"text"},{"key":"items[0][tax_percent]","value":"","type":"text"},{"key":"items[0][tax_rate_id]","value":"","type":"text"},{"key":"items[0][discount_type]","value":"1","type":"text"},{"key":"items[0][discount_amount]","value":"","type":"text"},{"key":"items[0][discount_percent]","value":"","type":"text"},{"key":"items[0][is_required]","value":"","type":"text","description":"int, optional conditional only for type =2 options estimate, locks the options
\n"},{"key":"items[1][id]","value":"0","type":"text"},{"key":"items[1][type]","value":"2","type":"text"},{"key":"items[1][name]","value":"Chemical","type":"text"},{"key":"items[1][description]","value":"","type":"text"},{"key":"items[1][price]","value":"50","type":"text"},{"key":"items[1][qty]","value":"1","type":"text"},{"key":"items[1][tax_percent]","value":"","type":"text"},{"key":"items[1][tax_rate_id]","value":"","type":"text"},{"key":"items[1][discount_type]","value":"1","type":"text"},{"key":"items[1][discount_amount]","value":"","type":"text"},{"key":"items[1][discount_percent]","value":"","type":"text"},{"key":"items[1][is_required]","value":"1","type":"text"}]},"url":"{{url}}/connect/api/v1/estimates","urlObject":{"path":["connect","api","v1","estimates"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"6e7be4bd-4055-4dca-9034-dcf09bd619c7"},{"name":"Create package estimate","id":"4ce09111-d0a2-4c81-9204-b444adffd087","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"3","type":"text","description":"int, required - 3 for package estimate
\n"},{"key":"customer_id","value":"14429","type":"text","description":"int, required - the customer to set on estimate
\n"},{"key":"customer_address_id","value":"-1","type":"text","description":"int, optional - If -1 will set the location as customer location, else if > 0 a valid customer_address_id is required
\n"},{"key":"custom_number","value":"EST-01204","type":"text","description":"string, conditionally required - On create if empty the system will auto-generate next number, also you can use invoices/config endpoint to get the next number, or set your own number
\n"},{"key":"custom_job_title","value":"Cleaning Job","type":"text","description":"string, optional
\n"},{"key":"purchase_order_number","value":"PO-148309","type":"text","description":"string, optional
\n"},{"key":"date_issued","value":"2025-10-20","type":"text","description":"string, optional
\n"},{"key":"date_expire","value":"2025-10-27","type":"text","description":"string, required
\n"},{"key":"item_list_type","value":"1","type":"text","description":"int, required - set 1 to set an tems list and 2 for item summary (one item)
\n"},{"key":"quantity_type","value":"","type":"text"},{"key":"adjustment_name","value":"Extra fee","type":"text"},{"key":"adjustment_type","value":"1","type":"text"},{"key":"adjustment_total","value":"2","type":"text"},{"key":"adjustment_percent","value":"","type":"text"},{"key":"message","value":"message","type":"text"},{"key":"terms","value":"terms","type":"text"},{"key":"notes","value":"some notes","type":"text"},{"key":"deposit_type","value":"1","type":"text","description":"int, optional - set to 1 for amount deposit and 2 for percentage deposit
\n"},{"key":"deposit_amount","value":"10","type":"text","description":"float, optional conditional if deposit_type = 1
\n"},{"key":"deposit_percent","value":"","type":"text","description":"float, optional conditional if deposit_type = 2
\n"},{"key":"items[0][id]","value":"0","type":"text"},{"key":"items[0][type]","value":"1","type":"text"},{"key":"items[0][name]","value":"Cleaning Package Gold","type":"text"},{"key":"items[0][description]","value":"","type":"text"},{"key":"items[0][price]","value":"100","type":"text"},{"key":"items[0][qty]","value":"1","type":"text"},{"key":"items[0][tax_percent]","value":"","type":"text"},{"key":"items[0][tax_rate_id]","value":"","type":"text"},{"key":"items[0][discount_type]","value":"1","type":"text"},{"key":"items[0][discount_amount]","value":"","type":"text"},{"key":"items[0][discount_percent]","value":"","type":"text"},{"key":"items[0][is_primary]","value":"1","type":"text","description":"int, conditional only for type =3 package estimate, mark the primary package
\n"},{"key":"items[0][estimate_package_id]","value":"","type":"text","description":"int, conditional only for type =3 package estimate, mark the primary package
\n"},{"key":"items[1][id]","value":"0","type":"text"},{"key":"items[1][type]","value":"1","type":"text"},{"key":"items[1][name]","value":"Cleaning Package Silver","type":"text"},{"key":"items[1][description]","value":"","type":"text"},{"key":"items[1][price]","value":"100","type":"text"},{"key":"items[1][qty]","value":"1","type":"text"},{"key":"items[1][tax_percent]","value":"","type":"text"},{"key":"items[1][tax_rate_id]","value":"","type":"text"},{"key":"items[1][discount_type]","value":"1","type":"text"},{"key":"items[1][discount_amount]","value":"","type":"text"},{"key":"items[1][discount_percent]","value":"","type":"text"},{"key":"items[1][is_primary]","value":" 0","type":"text"},{"key":"items[1][estimate_package_id]","value":"","type":"text"}]},"url":"{{url}}/connect/api/v1/estimates","urlObject":{"path":["connect","api","v1","estimates"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"4ce09111-d0a2-4c81-9204-b444adffd087"},{"name":"Create standard estimate for Lead","id":"bb072620-528d-4b5c-b7dc-5842397b6b4f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"1","type":"text","description":"int, required - allowed values 1 for standard estimate
\n"},{"key":"lead_id","value":"719","type":"text","description":"int, required - the lead to create the estimate for
\n"},{"key":"customer_address_id","value":"-1","type":"text","description":"int, optional - If -1 will set the location as customer location, else if > 0 a valid customer_address_id is required
\n"},{"key":"custom_number","value":"EST-01204","type":"text","description":"string, conditionally required - On create if empty the system will auto-generate next number, also you can use invoices/config endpoint to get the next number, or set your own number
\n"},{"key":"custom_job_title","value":"Cleaning Job 2","type":"text","description":"string, optional
\n"},{"key":"purchase_order_number","value":"PO-148309","type":"text","description":"string, optional
\n"},{"key":"date_issued","value":"2026-03-12","type":"text","description":"string, optional
\n"},{"key":"date_expire","value":"2026-03-17","type":"text","description":"string, required
\n"},{"key":"item_list_type","value":"1","type":"text","description":"int, required - set 1 to set an tems list and 2 for item summary (one item)
\n"},{"key":"quantity_type","value":"","type":"text"},{"key":"adjustment_name","value":"Extra fee","type":"text"},{"key":"adjustment_type","value":"1","type":"text"},{"key":"adjustment_total","value":"2","type":"text"},{"key":"adjustment_percent","value":"","type":"text"},{"key":"message","value":"message","type":"text"},{"key":"terms","value":"terms","type":"text"},{"key":"notes","value":"some notes","type":"text"},{"key":"deposit_type","value":"1","type":"text","description":"int, optional - set to 1 for amount deposit and 2 for percentage deposit
\n"},{"key":"deposit_amount","value":"10","type":"text","description":"float, optional conditional if deposit_type = 1
\n"},{"key":"deposit_percent","value":"","type":"text","description":"float, optional conditional if deposit_type = 2
\n"},{"key":"items[0][id]","value":"0","type":"text"},{"key":"items[0][type]","value":"1","type":"text"},{"key":"items[0][name]","value":"Cleaning","type":"text"},{"key":"items[0][description]","value":"","type":"text"},{"key":"items[0][price]","value":"100","type":"text"},{"key":"items[0][qty]","value":"1","type":"text"},{"key":"items[0][tax_percent]","value":"","type":"text"},{"key":"items[0][tax_rate_id]","value":"","type":"text"},{"key":"items[0][discount_type]","value":"1","type":"text"},{"key":"items[0][discount_amount]","value":"","type":"text"},{"key":"items[0][discount_percent]","value":"","type":"text","description":"int, conditional only for type =3 package estimate, mark the primary package
\n"}]},"url":"{{url}}/connect/api/v1/estimates","urlObject":{"path":["connect","api","v1","estimates"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"bb072620-528d-4b5c-b7dc-5842397b6b4f"},{"name":"Update estimate","id":"8575ea57-1a83-43b2-875f-8cad8ebe1507","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"customer_id","value":"3162","type":"text","description":"int, optional - can change the customer only if estimate status = D (Draft)
\n","disabled":true},{"key":"customer_address_id","value":"-1","type":"text"},{"key":"custom_number","value":"EST-01204","type":"text"},{"key":"custom_job_title","value":"Cleaning Job","type":"text"},{"key":"purchase_order_number","value":"PO-148309","type":"text"},{"key":"date_issued","value":"2025-10-20","type":"text"},{"key":"date_expire","value":"2025-10-27","type":"text"},{"key":"item_list_type","value":"1","type":"text"},{"key":"quantity_type","value":"","type":"text"},{"key":"adjustment_name","value":"Extra fee","type":"text"},{"key":"adjustment_type","value":"1","type":"text"},{"key":"adjustment_total","value":"2","type":"text"},{"key":"adjustment_percent","value":"","type":"text"},{"key":"message","value":"message","type":"text"},{"key":"terms","value":"terms","type":"text"},{"key":"notes","value":"some notes","type":"text"},{"key":"deposit_type","value":"1","type":"text","description":"int, required - If id = 0 a new item line will be inserted, else if id > 0 an existent item will be updated
\n"},{"key":"deposit_amount","value":"10","type":"text"},{"key":"deposit_percent","value":"","type":"text"},{"key":"items[0][id]","value":"0","type":"text"},{"key":"items[0][type]","value":"1","type":"text"},{"key":"items[0][name]","value":"Cleaning item","type":"text"},{"key":"items[0][description]","value":"","type":"text"},{"key":"items[0][price]","value":"100","type":"text"},{"key":"items[0][qty]","value":"1","type":"text"},{"key":"items[0][tax_percent]","value":"","type":"text"},{"key":"items[0][tax_rate_id]","value":"","type":"text"},{"key":"items[0][discount_type]","value":"1","type":"text"},{"key":"items[0][discount_amount]","value":"","type":"text"},{"key":"items[0][discount_percent]","value":"","type":"text"}]},"url":"{{url}}/connect/api/v1/estimates/8298","description":"You can use a sparse object to update certain fields or full object.
\n","urlObject":{"path":["connect","api","v1","estimates","8298"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"8575ea57-1a83-43b2-875f-8cad8ebe1507"},{"name":"Delete estimate","id":"8bb56485-28ba-47cb-82ca-65803c1ce68d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/estimates/48595","urlObject":{"path":["connect","api","v1","estimates","48595"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"cd2f0e97-c248-45e0-9198-be6716d0c89a","name":"Delete customer","originalRequest":{"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/customers/19337"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"delete\": true,\n \"id\": \"19337\"\n}"}],"_postman_id":"8bb56485-28ba-47cb-82ca-65803c1ce68d"},{"name":"Send estimate","id":"d9d4f914-2dc3-4839-ba25-48e7efbfebaa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"{{url}}/connect/api/v1/estimates/3567/send","urlObject":{"path":["connect","api","v1","estimates","3567","send"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"d9d4f914-2dc3-4839-ba25-48e7efbfebaa"}],"id":"422b1151-57f9-41a2-979a-caf15d6dd868","event":[{"listen":"prerequest","script":{"id":"bb15b026-2df6-4d09-8e3c-2c6fd1347779","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"dab3e258-849c-4ac4-ad02-3ee865d84532","type":"text/javascript","exec":[""]}}],"_postman_id":"422b1151-57f9-41a2-979a-caf15d6dd868","description":""},{"name":"Estimate Attachments","item":[{"name":"List all attachments","id":"ff7c84fe-fb1c-4400-a7a0-a80a733a5fa3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/estimate/attachments?estimate_id=100","description":"A list of estimate_attachment object. The API returns max 20 attachments for the requested estimate.
\n","urlObject":{"path":["connect","api","v1","estimate","attachments"],"host":["{{url}}"],"query":[{"key":"estimate_id","value":"100"}],"variable":[]}},"response":[{"id":"887157b7-1cda-418d-9062-de64206d546f","name":"List all attachments","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":{"raw":"{{url}}/connect/api/v1/invoice/attachments?invoice_id=53179","host":["{{url}}"],"path":["connect","api","v1","invoice","attachments"],"query":[{"key":"invoice_id","value":"53179"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Thu, 07 May 2026 15:33:56 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/7.4.33"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"estimate_attachments\": [\n { \n \"id\": \"111\",\n \"estimate_id\": \"222\",\n \"name_original\": \"cabinet.jpg\",\n \"name_custom\": null,\n \"type\": \"image/jpeg\",\n \"extension\": \"jpg\",\n \"size\": \"30964\",\n \"encrypted\": \"0\",\n \"url\": \"https://...\",\n \"url_thumbnail\": \"https://...\", \n \"is_image\": true,\n \"datetime_added\": \"2026-05-07T15:27:22+00:00\",\n \"datetime_updated\": null\n }, \n ]\n}\n"}],"_postman_id":"ff7c84fe-fb1c-4400-a7a0-a80a733a5fa3"},{"name":"Upload attachment","id":"c2a9ae9b-8ba7-4c8c-bbd7-ed8a958f66ca","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":" multipart/form-data","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"File to be uploaded, using multipart/form-data protocol.
\n","type":"file","value":null}]},"url":"{{url}}/connect/api/v1/estimate/attachments/upload?estimate_id=100","description":"To upload a file you need to send a request with header Content-Type: multipart/form-data. Include the file you want to upload in the request. File data is sent as sections in a multipart document in the body of the request.
\n","urlObject":{"path":["connect","api","v1","estimate","attachments","upload"],"host":["{{url}}"],"query":[{"key":"estimate_id","value":"100"}],"variable":[]}},"response":[],"_postman_id":"c2a9ae9b-8ba7-4c8c-bbd7-ed8a958f66ca"},{"name":"Delete attachment","id":"324dde7c-bd53-44a2-b505-362c08a5be3b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/estimate/attachments/200?estimate_id=100","urlObject":{"path":["connect","api","v1","estimate","attachments","200"],"host":["{{url}}"],"query":[{"key":"estimate_id","value":"100"}],"variable":[]}},"response":[],"_postman_id":"324dde7c-bd53-44a2-b505-362c08a5be3b"}],"id":"2150325a-fcec-4eda-9487-2e5c6f20361b","_postman_id":"2150325a-fcec-4eda-9487-2e5c6f20361b","description":""},{"name":"Events","item":[{"name":"List events","id":"c47cf954-e2eb-4ac1-82fd-0a987110c09f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/events?date_start=2023-05-01&date_end=2023-05-31&work_order_id=&employee_id=&type=5","description":"Will return maximum 400 events and the interval between date_start and date_end can not be over 93 days (~ 3 months)
\nA list of Event object
\n","urlObject":{"path":["connect","api","v1","events"],"host":["{{url}}"],"query":[{"description":{"content":"required, string - Format yyyy-mm-dd get all events starting from this date
\n","type":"text/plain"},"key":"date_start","value":"2023-05-01"},{"description":{"content":"required, string - Format yyyy-mm-dd get all events up to this date
\n","type":"text/plain"},"key":"date_end","value":"2023-05-31"},{"description":{"content":"optional, int - Filter by work order
\n","type":"text/plain"},"key":"work_order_id","value":""},{"description":{"content":"optional, int - Filter by employee
\n","type":"text/plain"},"key":"employee_id","value":""},{"key":"type","value":"5"}],"variable":[]}},"response":[{"id":"9c3f1bf8-1c92-4ac3-b9a3-55277555076e","name":"List events","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":{"raw":"{{url}}/connect/api/v1/events?date_start=2021-01-01&date_end=2021-04-01","host":["{{url}}"],"path":["connect","api","v1","events"],"query":[{"key":"date_start","value":"2021-01-01","description":"required, string - Format yyyy-mm-dd get all events starting from this date"},{"key":"date_end","value":"2021-04-01","description":"required, string - Format yyyy-mm-dd get all events up to this date"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"events\": [\n {\n\t \"id\": \"999\",\n\t \"type\": \"1\",\n\t \"is_type_blocked\": false,\n\t \"is_type_customer\": true,\n\t \"is_type_lead\": false,\n\t \"is_type_work_order\": false,\n\t \"work_order_id\": \"0\",\n\t \"customer\": {\n\t \"id\": \"19321\",\n\t \"display_name\": \"John Doe\",\n\t \"first_name\": \"John\",\n\t \"last_name\": \"Doe\",\n\t \"email\": \"johndoe@test.com\",\n\t \"phone\": \"2123334444\"\n\t },\n\t \"location\": {\n\t \"address\": \"300 North Los Angeles Street\",\n\t \"address_secondary\": \"Suite 10\",\n\t \"city\": \"Los Angeles\",\n\t \"state\": \"CA\",\n\t \"zip\": \"90012\"\n\t },\n\t \"name\": \"Carpet Cleaning\",\n\t \"datetime_start\": \"2021-03-12 10:00:00\",\n\t \"datetime_start_iso\": \"2021-03-12T10:00:00-05:00\",\n\t \"datetime_end\": \"2021-03-12 11:00:00\",\n\t \"datetime_end_iso\": \"2021-03-12T11:00:00-05:00\",\n\t \"timezone\": \"America/New_York\",\n\t \"timezone_text\": \"Eastern Time (UTC -4)\",\n\t \"color\": {\n\t \"id\": 1,\n\t \"code\": \"#4cb052\"\n\t },\n\t \"all_day\": false,\n\t \"notify_at\": \"PT2H\",\n\t \"notify_at_text\": \"2 hours before\",\n\t \"notes\": \"Has 2 dogs\",\n\t \"is_recurring\": false,\n\t \"datetime_added\": \"2021-03-16T02:48:36+00:00\",\n\t \"datetime_updated\": null\n },\n ]\n}"}],"_postman_id":"c47cf954-e2eb-4ac1-82fd-0a987110c09f"},{"name":"List events ical","id":"000cfe73-d94b-46dc-828e-dac07d613971","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/events/ical?date_start=2023-05-01&date_end=2023-05-31&work_order_id=&employee_id=","description":"Will return maximum 400 events and the interval between date_start and date_end can not be over 93 days (~ 3 months)
\nA list of Event object
\n","urlObject":{"path":["connect","api","v1","events","ical"],"host":["{{url}}"],"query":[{"description":{"content":"required, string - Format yyyy-mm-dd get all events starting from this date
\n","type":"text/plain"},"key":"date_start","value":"2023-05-01"},{"description":{"content":"required, string - Format yyyy-mm-dd get all events up to this date
\n","type":"text/plain"},"key":"date_end","value":"2023-05-31"},{"description":{"content":"optional, int - Filter by work order
\n","type":"text/plain"},"key":"work_order_id","value":""},{"description":{"content":"optional, int - Filter by employee
\n","type":"text/plain"},"key":"employee_id","value":""}],"variable":[]}},"response":[{"id":"02f2d5ce-c257-4112-bb0b-33004cb40c5c","name":"List events","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":{"raw":"{{url}}/connect/api/v1/events?date_start=2021-01-01&date_end=2021-04-01","host":["{{url}}"],"path":["connect","api","v1","events"],"query":[{"key":"date_start","value":"2021-01-01","description":"required, string - Format yyyy-mm-dd get all events starting from this date"},{"key":"date_end","value":"2021-04-01","description":"required, string - Format yyyy-mm-dd get all events up to this date"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"events\": [\n {\n\t \"id\": \"999\",\n\t \"type\": \"1\",\n\t \"is_type_blocked\": false,\n\t \"is_type_customer\": true,\n\t \"is_type_lead\": false,\n\t \"is_type_work_order\": false,\n\t \"work_order_id\": \"0\",\n\t \"customer\": {\n\t \"id\": \"19321\",\n\t \"display_name\": \"John Doe\",\n\t \"first_name\": \"John\",\n\t \"last_name\": \"Doe\",\n\t \"email\": \"johndoe@test.com\",\n\t \"phone\": \"2123334444\"\n\t },\n\t \"location\": {\n\t \"address\": \"300 North Los Angeles Street\",\n\t \"address_secondary\": \"Suite 10\",\n\t \"city\": \"Los Angeles\",\n\t \"state\": \"CA\",\n\t \"zip\": \"90012\"\n\t },\n\t \"name\": \"Carpet Cleaning\",\n\t \"datetime_start\": \"2021-03-12 10:00:00\",\n\t \"datetime_start_iso\": \"2021-03-12T10:00:00-05:00\",\n\t \"datetime_end\": \"2021-03-12 11:00:00\",\n\t \"datetime_end_iso\": \"2021-03-12T11:00:00-05:00\",\n\t \"timezone\": \"America/New_York\",\n\t \"timezone_text\": \"Eastern Time (UTC -4)\",\n\t \"color\": {\n\t \"id\": 1,\n\t \"code\": \"#4cb052\"\n\t },\n\t \"all_day\": false,\n\t \"notify_at\": \"PT2H\",\n\t \"notify_at_text\": \"2 hours before\",\n\t \"notes\": \"Has 2 dogs\",\n\t \"is_recurring\": false,\n\t \"datetime_added\": \"2021-03-16T02:48:36+00:00\",\n\t \"datetime_updated\": null\n },\n ]\n}"}],"_postman_id":"000cfe73-d94b-46dc-828e-dac07d613971"},{"name":"Get event","id":"babced82-9069-4159-bd34-f0958d86c251","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/events/2591","urlObject":{"path":["connect","api","v1","events","2591"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"9b15a34f-fe75-45fc-bba2-e71f16194460","name":"Get event","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/events/958"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"event\": {\n \"id\": \"958\",\n \"type\": \"1\",\n \"is_type_blocked\": false,\n \"is_type_customer\": true,\n \"is_type_lead\": false,\n \"is_type_work_order\": false,\n \"work_order_id\": \"0\",\n \"customer\": {\n \"id\": \"3142\",\n \"display_name\": \"Aisha Voss\",\n \"first_name\": \"Aisha\",\n \"last_name\": \"Voss\",\n \"email\": \"aisha@gmail.com\",\n \"phone\": \"6232995971\"\n },\n \"location\": {\n \"address\": \"55 Fruit Street\",\n \"address_secondary\": \"\",\n \"city\": \"Boston\",\n \"state\": \"MA\",\n \"zip\": \"02114\"\n },\n \"name\": \"F\",\n \"datetime_start\": \"2021-01-08 21:00:00\",\n \"datetime_start_iso\": \"2021-01-08T21:00:00-05:00\",\n \"datetime_end\": \"2021-01-08 22:00:00\",\n \"datetime_end_iso\": \"2021-01-08T22:00:00-05:00\",\n \"timezone\": \"America/New_York\",\n \"timezone_text\": \"Eastern Time (UTC -4)\",\n \"color\": {\n \"id\": 1,\n \"code\": \"#4cb052\"\n },\n \"all_day\": false,\n \"notify_at\": \"PT5M\",\n \"notify_at_text\": \"5 minutes before\",\n \"notes\": \"\",\n \"is_recurring\": false,\n \"datetime_added\": \"2021-01-09T02:34:45+00:00\",\n \"datetime_updated\": null\n }\n}"}],"_postman_id":"babced82-9069-4159-bd34-f0958d86c251"},{"name":"Get events config","id":"5b1bc772-a904-4819-b34d-335a45c5206b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/events/config","description":"Returns additional objects needed to create an event:
\nevent colors
A list of colors to assign to events
notify_at
When to notify the customer
timezones
Available timezone list
timezone_default
Default events/calendar timezone
int, required - Allowed values 1 for normal event, 2 for work order event, 4 for lead event
\n"},{"key":"customer_id","value":"33855","type":"text","description":"int, required - The customer id
\n"},{"key":"customer_address_id","value":"2492","type":"text"},{"key":"employee_id[0]","value":"394","type":"text","description":"int[], optional - If not set the work order will be assigned to owner, else if set a valid array of employee ids is required
\n"},{"key":"employee_id[1]","value":"560","type":"text"},{"key":"name","value":"Carpet Cleaning","type":"text","description":"string, required - Event start date and time as input by user
\n"},{"key":"datetime_start","value":"2024-06-01 10:00:00","type":"text","description":"string, required - Event end date and time as input by user
\n"},{"key":"datetime_end","value":"2024-06-01 11:00:00","type":"text","description":"int, required - Default 0, If set to 1 the datetime_start and datetime_end time will be ignored
\n"},{"key":"all_day","value":"0","type":"text","description":"optional - If not set will use the default timezone, see /events/config endpoint timezone_default
\n"},{"key":"timezone","value":"America/Phoenix","type":"text","description":"int, required - A color id, default 1
\n","disabled":true},{"key":"color_id","value":"1","type":"text","description":"string, optional - A date-time interval, If not set it will default to user settings
\n"},{"key":"notify_at","value":"PT2H","type":"text","description":"string, optional - some notes
\n","disabled":true},{"key":"notes","value":"Has 2 dogs","type":"text"}]},"url":"{{url}}/connect/api/v1/events","urlObject":{"path":["connect","api","v1","events"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"7349504b-9637-4ae1-84b8-96321fcfa8bc","name":"Create event","originalRequest":{"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"1","type":"text","description":"int, required - Allowed values 1 for normal event, 2 for work order event"},{"key":"customer_id","value":"19321","type":"text","description":"int, required - The customer id"},{"key":"name","value":"Carpet Cleaning","type":"text","description":"string, required - Event name"},{"key":"datetime_start","value":"2021-03-12 10:00:00","type":"text","description":"string, required - Event start date and time as input by user"},{"key":"datetime_end","value":"2021-03-12 11:00:00","type":"text","description":"string, required - Event end date and time as input by user"},{"key":"all_day","value":"0","type":"text","description":"int, required - Default 0, If set to 1 the datetime_start and datetime_end time will be ignored"},{"key":"timezone","value":"America/Phoenix","type":"text","description":"optional - If not set will use the default timezone, see /events/config endpoint timezone_default","disabled":true},{"key":"color_id","value":"1","type":"text","description":"int, required - A color id, default 1"},{"key":"notify_at","value":"PT2H","type":"text","description":"string, required - A date-time interval"},{"key":"notes","value":"Has 2 dogs","type":"text","description":"string, optional - some notes"}]},"url":"{{url}}/connect/api/v1/events"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"event\": {\n \"id\": \"999\",\n \"type\": \"1\",\n \"is_type_blocked\": false,\n \"is_type_customer\": true,\n \"is_type_lead\": false,\n \"is_type_work_order\": false,\n \"work_order_id\": \"0\",\n \"customer\": {\n \"id\": \"19321\",\n \"display_name\": \"John Doe\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"johndoe@test.com\",\n \"phone\": \"2123334444\"\n },\n \"location\": {\n \"address\": \"300 North Los Angeles Street\",\n \"address_secondary\": \"Suite 10\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90012\"\n },\n \"name\": \"Carpet Cleaning\",\n \"datetime_start\": \"2021-03-12 10:00:00\",\n \"datetime_start_iso\": \"2021-03-12T10:00:00-05:00\",\n \"datetime_end\": \"2021-03-12 11:00:00\",\n \"datetime_end_iso\": \"2021-03-12T11:00:00-05:00\",\n \"timezone\": \"America/New_York\",\n \"timezone_text\": \"Eastern Time (UTC -4)\",\n \"color\": {\n \"id\": 1,\n \"code\": \"#4cb052\"\n },\n \"all_day\": false,\n \"notify_at\": \"PT2H\",\n \"notify_at_text\": \"2 hours before\",\n \"notes\": \"Has 2 dogs\",\n \"is_recurring\": false,\n \"datetime_added\": \"2021-03-16T02:48:36+00:00\",\n \"datetime_updated\": null\n }\n}"}],"_postman_id":"d8a93393-f0fc-4872-a27c-652b89760355"},{"name":"Create event - Work Order","id":"e785d1f1-6c2b-4e7b-b2ee-75d18032b814","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"2","type":"text","description":"int, required - Type = 2 to create a Work Order event
\n"},{"key":"work_order_id","value":"11082","type":"text","description":"int, required - The work order id
\n"},{"key":"employee_id[0]","value":"388","type":"text","description":"int[], optional - If not set the work order will be assigned to owner, else if set a valid array of employee ids is required
\n"},{"key":"employee_id[1]","value":"100","type":"text"},{"key":"name","value":"Carpet Cleaning","type":"text","description":"string, required - Event name
\n"},{"key":"datetime_start","value":"2021-09-12 10:00:00","type":"text","description":"string, required - Event start date and time as input by user
\n"},{"key":"datetime_end","value":"2021-09-12 11:00:00","type":"text","description":"string, required - Event end date and time as input by user
\n"},{"key":"all_day","value":"0","type":"text","description":"int, required - Default 0, If set to 1 the datetime_start and datetime_end time will be ignored
\n"},{"key":"timezone","value":"America/Phoenix","type":"text","description":"optional - If not set will use the default timezone, see /events/config endpoint timezone_default
\n","disabled":true},{"key":"color_id","value":"1","type":"text","description":"int, required - A color id, default 1
\n"},{"key":"notify_at","value":"PT2H","type":"text","description":"string, optional - A date-time interval, If not set it will default to user settings
\n","disabled":true},{"key":"notes","value":"Has 2 dogs","type":"text","description":"string, optional - some notes
\n"}]},"url":"{{url}}/connect/api/v1/events","urlObject":{"path":["connect","api","v1","events"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"dd100697-af37-4ab2-9455-2807eefbc6c6","name":"Create event","originalRequest":{"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"1","type":"text","description":"int, required - Allowed values 1 for normal event, 2 for work order event"},{"key":"customer_id","value":"19321","type":"text","description":"int, required - The customer id"},{"key":"name","value":"Carpet Cleaning","type":"text","description":"string, required - Event name"},{"key":"datetime_start","value":"2021-03-12 10:00:00","type":"text","description":"string, required - Event start date and time as input by user"},{"key":"datetime_end","value":"2021-03-12 11:00:00","type":"text","description":"string, required - Event end date and time as input by user"},{"key":"all_day","value":"0","type":"text","description":"int, required - Default 0, If set to 1 the datetime_start and datetime_end time will be ignored"},{"key":"timezone","value":"America/Phoenix","type":"text","description":"optional - If not set will use the default timezone, see /events/config endpoint timezone_default","disabled":true},{"key":"color_id","value":"1","type":"text","description":"int, required - A color id, default 1"},{"key":"notify_at","value":"PT2H","type":"text","description":"string, required - A date-time interval"},{"key":"notes","value":"Has 2 dogs","type":"text","description":"string, optional - some notes"}]},"url":"{{url}}/connect/api/v1/events"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"event\": {\n \"id\": \"1000\",\n \"type\": \"2\",\n \"is_type_blocked\": false,\n \"is_type_customer\": false,\n \"is_type_lead\": false,\n \"is_type_work_order\": true,\n \"work_order_id\": \"2458\",\n \"customer\": {\n \"id\": \"19321\",\n \"display_name\": \"John Doe\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"johndoe@test.com\",\n \"phone\": \"2123334444\"\n },\n \"location\": {\n \"address\": \"300 North Los Angeles Street\",\n \"address_secondary\": \"Suite 10\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90012\"\n },\n \"name\": \"Carpet Cleaning\",\n \"datetime_start\": \"2021-03-14 10:00:00\",\n \"datetime_start_iso\": \"2021-03-14T10:00:00-07:00\",\n \"datetime_end\": \"2021-03-14 11:00:00\",\n \"datetime_end_iso\": \"2021-03-14T11:00:00-07:00\",\n \"timezone\": \"America/Phoenix\",\n \"timezone_text\": \"Arizona Time (UTC -7)\",\n \"color\": {\n \"id\": 1,\n \"code\": \"#4cb052\"\n },\n \"all_day\": false,\n \"notify_at\": \"PT2H\",\n \"notify_at_text\": \"2 hours before\",\n \"notes\": \"Some notes\",\n \"is_recurring\": false,\n \"datetime_added\": \"2021-03-16T02:55:41+00:00\",\n \"datetime_updated\": null\n }\n}"}],"_postman_id":"e785d1f1-6c2b-4e7b-b2ee-75d18032b814"},{"name":"Create event - Task","id":"20d68bd4-1190-48cc-a9a0-fcff1827177f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"5","type":"text","description":"int, required - Value 5 for task event
\n"},{"key":"name","value":"Sample Task","type":"text","description":"string, required
\n"},{"key":"notes","value":"Description or some notes","type":"text","description":"string, required
\n"},{"key":"customer_id","value":"14429","description":"int, optional
\n","type":"text"},{"key":"employee_id[0]","value":"386","type":"text","description":"int[], optional
\n"},{"key":"datetime_start","value":"2023-05-12 10:00:00","type":"text","description":"string, required
\n"},{"key":"timezone","value":"America/New_York","type":"text","description":"string, required
\n"},{"key":"color_id","value":"1","type":"text","description":"int, required - A color id, default 1
\n"},{"key":"task_status","value":"1","type":"text","description":"int, required - Values: 1 = task is active, 2 = task is completed
\n"},{"key":"task_priority","value":"1","type":"text","description":"int, required, 1 = low, 2 = medium, 3 = high
\n"}]},"url":"{{url}}/connect/api/v1/events","urlObject":{"path":["connect","api","v1","events"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"27adbd54-f287-4246-90c7-affb7df18061","name":"Create event - Task","originalRequest":{"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"5","type":"text","description":"int, required - Value 5 for task event"},{"key":"name","value":"A Task","type":"text","description":"string, required"},{"key":"notes","value":"Description or some notes","type":"text","description":"string, required"},{"key":"customer_id","value":"14429","description":"int, optional","type":"text"},{"key":"employee_id[0]","value":"386","type":"text","description":"int[], optional"},{"key":"datetime_start","value":"2023-05-11 10:00:00","type":"text","description":"string, required"},{"key":"timezone","value":"America/New_York","type":"text","description":"string, required"},{"key":"color_id","value":"1","type":"text","description":"int, required - A color id, default 1"},{"key":"task_status","value":"1","type":"text","description":"int, required - Values: 1 = task is active, 2 = task is completed"},{"key":"task_priority","value":"1","type":"text","description":"int, required, 1 = low, 2 = medium, 3 = high"}]},"url":"{{url}}/connect/api/v1/events"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Thu, 07 May 2026 18:37:11 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/7.4.33"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"}],"cookie":[],"responseTime":null,"body":"{\n \"event\": {\n \"id\": \"2931\",\n \"type\": \"5\",\n \"is_type_blocked\": false,\n \"is_type_customer\": false,\n \"is_type_lead\": false,\n \"is_type_task\": true,\n \"is_type_work_order\": false,\n \"work_order_id\": \"0\",\n \"customer\": {\n \"id\": \"14429\",\n \"display_name\": \"Amanda Stone\",\n \"first_name\": \"Amanda\",\n \"last_name\": \"Stone\",\n \"email\": \"amanda@test.com\",\n \"phone\": \"5345345435\"\n },\n \"employees\": [\n {\n \"id\": \"386\",\n \"first_name\": \"Dany\",\n \"last_name\": \"Howard\",\n \"is_owner\": false\n }\n ],\n \"location\": {\n \"address\": \"222 East 41st Street\",\n \"address_secondary\": \"\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"zip\": \"10017\"\n },\n \"name\": \"A Task\",\n \"datetime_start\": \"2023-05-11 10:00:00\",\n \"datetime_start_iso\": \"2023-05-11T10:00:00-04:00\",\n \"datetime_end\": \"2023-05-11 10:30:00\",\n \"datetime_end_iso\": \"2023-05-11T10:30:00-04:00\",\n \"timezone\": \"America/New_York\",\n \"timezone_text\": \"Eastern Time (UTC -4)\",\n \"color\": {\n \"id\": 1,\n \"code\": \"#4cb052\"\n },\n \"all_day\": false,\n \"notify_at\": \"PT5M\",\n \"notify_at_text\": \"5 minutes before\",\n \"notes\": \"Description or some notes\",\n \"is_recurring\": false,\n \"datetime_added\": \"2026-05-07T18:37:11+00:00\",\n \"datetime_updated\": null\n }\n}"}],"_postman_id":"20d68bd4-1190-48cc-a9a0-fcff1827177f"},{"name":"Create event - Lead","id":"62ec7f73-388b-47db-896e-fb436b3304fe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"4","type":"text","description":"int, required - Allowed values 1 for normal event, 2 for work order event
\n"},{"key":"lead_id","value":"751","type":"text","description":"int, required - A valid Lead id
\n"},{"key":"customer_address_id","value":"0","type":"text"},{"key":"employee_id[0]","value":"394","type":"text","description":"int[], optional - If not set the work order will be assigned to owner, else if set a valid array of employee ids is required
\n"},{"key":"employee_id[1]","value":"560","type":"text"},{"key":"name","value":"Carpet Cleaning 2","type":"text","description":"string, required - Event start date and time as input by user
\n"},{"key":"datetime_start","value":"2026-03-14 10:00:00","type":"text","description":"string, required - Event end date and time as input by user
\n"},{"key":"datetime_end","value":"2026-03-14 11:00:00","type":"text","description":"int, required - Default 0, If set to 1 the datetime_start and datetime_end time will be ignored
\n"},{"key":"all_day","value":"0","type":"text","description":"optional - If not set will use the default timezone, see /events/config endpoint timezone_default
\n"},{"key":"timezone","value":"America/Phoenix","type":"text","description":"int, required - A color id, default 1
\n","disabled":true},{"key":"color_id","value":"1","type":"text","description":"string, optional - A date-time interval, If not set it will default to user settings
\n"},{"key":"notify_at","value":"PT2H","type":"text","description":"string, optional - some notes
\n","disabled":true},{"key":"notes","value":"Has 2 dogs","type":"text"}]},"url":"{{url}}/connect/api/v1/events","urlObject":{"path":["connect","api","v1","events"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"b3ebc45f-630b-4697-b9fe-467c6fad72cd","name":"Create event","originalRequest":{"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"1","type":"text","description":"int, required - Allowed values 1 for normal event, 2 for work order event"},{"key":"customer_id","value":"19321","type":"text","description":"int, required - The customer id"},{"key":"name","value":"Carpet Cleaning","type":"text","description":"string, required - Event name"},{"key":"datetime_start","value":"2021-03-12 10:00:00","type":"text","description":"string, required - Event start date and time as input by user"},{"key":"datetime_end","value":"2021-03-12 11:00:00","type":"text","description":"string, required - Event end date and time as input by user"},{"key":"all_day","value":"0","type":"text","description":"int, required - Default 0, If set to 1 the datetime_start and datetime_end time will be ignored"},{"key":"timezone","value":"America/Phoenix","type":"text","description":"optional - If not set will use the default timezone, see /events/config endpoint timezone_default","disabled":true},{"key":"color_id","value":"1","type":"text","description":"int, required - A color id, default 1"},{"key":"notify_at","value":"PT2H","type":"text","description":"string, required - A date-time interval"},{"key":"notes","value":"Has 2 dogs","type":"text","description":"string, optional - some notes"}]},"url":"{{url}}/connect/api/v1/events"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"event\": {\n \"id\": \"999\",\n \"type\": \"1\",\n \"is_type_blocked\": false,\n \"is_type_customer\": true,\n \"is_type_lead\": false,\n \"is_type_work_order\": false,\n \"work_order_id\": \"0\",\n \"customer\": {\n \"id\": \"19321\",\n \"display_name\": \"John Doe\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"johndoe@test.com\",\n \"phone\": \"2123334444\"\n },\n \"location\": {\n \"address\": \"300 North Los Angeles Street\",\n \"address_secondary\": \"Suite 10\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90012\"\n },\n \"name\": \"Carpet Cleaning\",\n \"datetime_start\": \"2021-03-12 10:00:00\",\n \"datetime_start_iso\": \"2021-03-12T10:00:00-05:00\",\n \"datetime_end\": \"2021-03-12 11:00:00\",\n \"datetime_end_iso\": \"2021-03-12T11:00:00-05:00\",\n \"timezone\": \"America/New_York\",\n \"timezone_text\": \"Eastern Time (UTC -4)\",\n \"color\": {\n \"id\": 1,\n \"code\": \"#4cb052\"\n },\n \"all_day\": false,\n \"notify_at\": \"PT2H\",\n \"notify_at_text\": \"2 hours before\",\n \"notes\": \"Has 2 dogs\",\n \"is_recurring\": false,\n \"datetime_added\": \"2021-03-16T02:48:36+00:00\",\n \"datetime_updated\": null\n }\n}"}],"_postman_id":"62ec7f73-388b-47db-896e-fb436b3304fe"},{"name":"Update event","id":"1691c1a2-9f8d-4ee0-82d6-eb96e7e6c250","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"name","value":"Carpet Cleaning updated","type":"text"},{"key":"datetime_start","value":"2021-09-12 13:20:00","type":"text","disabled":true},{"key":"datetime_end","value":"2021-09-14 14:05:00","type":"text","disabled":true},{"key":"timezone","value":"America/Chicago","type":"text","disabled":true},{"key":"employee_id[0]","value":"394","type":"text","description":"Optional, int - Change the employee assigned to event or work order
\n","disabled":true},{"key":"employee_id[1]","value":"560","type":"text","disabled":true},{"key":"all_day","value":"0","type":"text","disabled":true},{"key":"color_id","value":"1","type":"text","disabled":true},{"key":"notify_at","value":"PT2H","type":"text","disabled":true},{"key":"notes","value":"Has 2 dogs and a cat","type":"text","disabled":true}]},"url":"{{url}}/connect/api/v1/events/2302","description":"You can use a sparse object to update certain fields or full object.
\n","urlObject":{"path":["connect","api","v1","events","2302"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1691c1a2-9f8d-4ee0-82d6-eb96e7e6c250"},{"name":"Delete event","id":"bf565291-b22f-4d99-9fbe-e52bddecc567","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"url":"{{url}}/connect/api/v1/events/997","urlObject":{"path":["connect","api","v1","events","997"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"cfea5d55-b01c-4a0e-9799-207b0820a1f8","name":"Delete event","originalRequest":{"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"url":"{{url}}/connect/api/v1/events/997"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"delete\": true,\n \"id\": \"997\"\n}"}],"_postman_id":"bf565291-b22f-4d99-9fbe-e52bddecc567"}],"id":"ba5a16b2-3203-4877-ab83-d712d961e690","event":[{"listen":"prerequest","script":{"id":"604bdec7-b73a-461b-9aee-4efd67d24ede","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"83e688b2-7549-43d1-af57-328db5ecb385","type":"text/javascript","exec":[""]}}],"_postman_id":"ba5a16b2-3203-4877-ab83-d712d961e690","description":""},{"name":"Event Tasks","item":[{"name":"List tasks","id":"69650621-4ff3-4e8a-8671-0b2f2de59882","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/event/tasks?order=&search=&task_status=&customer_id=&lead_id=&page=&rows_per_page=","description":"Will return maximum 400 events and the interval between date_start and date_end can not be over 93 days (~ 3 months)
\nA list of Event object
\n","urlObject":{"path":["connect","api","v1","event","tasks"],"host":["{{url}}"],"query":[{"description":{"content":"string, optional - Sort using date-asc, date-desc, name-asc, name-desc, priority-asc, priority-desc
\n","type":"text/plain"},"key":"order","value":""},{"description":{"content":"string, optional
\n","type":"text/plain"},"key":"search","value":""},{"description":{"content":"int, optional - Allowed values: 1 = active, 2 = completed
\n","type":"text/plain"},"key":"task_status","value":""},{"description":{"content":"int, optional - List only tasks for a customer
\n","type":"text/plain"},"key":"customer_id","value":""},{"description":{"content":"int, optional - List only tasks for a lead
\n","type":"text/plain"},"key":"lead_id","value":""},{"key":"page","value":""},{"key":"rows_per_page","value":""}],"variable":[]}},"response":[{"id":"e277cb1f-76c9-405b-bab6-c4c11f906f1e","name":"List tasks","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":{"raw":"{{url}}/connect/api/v1/event/tasks?rows_per_page=&page=&order=&search=&task_status=&customer_id=&lead_id=","host":["{{url}}"],"path":["connect","api","v1","event","tasks"],"query":[{"key":"rows_per_page","value":""},{"key":"page","value":""},{"key":"order","value":""},{"key":"search","value":""},{"key":"task_status","value":""},{"key":"customer_id","value":"","description":"int, optional - list only tasks for a customer"},{"key":"lead_id","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 30 May 2024 13:00:52 GMT"},{"key":"Server","value":"Apache/2.4.38 (Debian)"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"Content-Length","value":"1224"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"events\": [\n {\n \"id\": \"7266\",\n \"type\": \"5\",\n \"is_type_blocked\": false,\n \"is_type_customer\": false,\n \"is_type_lead\": false,\n \"is_type_task\": true,\n \"is_type_work_order\": false,\n \"work_order_id\": \"0\",\n \"customer\": {\n \"id\": \"58645\",\n \"display_name\": \"Abacus Amos\",\n \"first_name\": \"Abacus\",\n \"last_name\": \"Amos\",\n \"email\": \"and.mohareb@gmail.com\",\n \"phone\": \"2222222222\"\n },\n \"employees\": [\n {\n \"id\": \"1190\",\n \"first_name\": \"Andrea\",\n \"last_name\": \"Howard\",\n \"is_owner\": false\n }\n ],\n \"location\": {\n \"address\": \"4800 Raven Ridge Drive\",\n \"address_secondary\": \"\",\n \"city\": \"Houston\",\n \"state\": \"TX\",\n \"zip\": \"77053\"\n },\n \"name\": \"A Task\",\n \"datetime_start\": \"2023-05-11 10:00:00\",\n \"datetime_start_iso\": \"2023-05-11T10:00:00-04:00\",\n \"datetime_end\": \"2023-05-11 10:30:00\",\n \"datetime_end_iso\": \"2023-05-11T10:30:00-04:00\",\n \"timezone\": \"America/New_York\",\n \"timezone_text\": \"Eastern Time (UTC -4)\",\n \"color\": {\n \"id\": 1,\n \"code\": \"#4cb052\"\n },\n \"all_day\": false,\n \"notify_at\": \"PT1H\",\n \"notify_at_text\": \"1 hour before\",\n \"notes\": \"Description or some notes\",\n \"is_recurring\": false,\n \"datetime_added\": \"2024-05-30T11:33:07+00:00\",\n \"datetime_updated\": \"2024-05-30T11:43:06+00:00\"\n }\n ],\n \"pagination\": {\n \"page\": 1,\n \"next\": 0,\n \"previous\": 0,\n \"rows_per_page\": 20,\n \"total_rows\": 1,\n \"total_pages\": 1\n },\n \"status_count\": [\n {\n \"id\": 1,\n \"name\": \"Active\",\n \"value\": \"1\"\n },\n {\n \"id\": 2,\n \"name\": \"Completed\",\n \"value\": 0\n }\n ]\n}"}],"_postman_id":"69650621-4ff3-4e8a-8671-0b2f2de59882"},{"name":"Update task status","id":"1562c5f7-5214-494f-8f7c-b3fd144ebc67","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"task_status","value":"1","type":"text","description":"int, required - Allowed values 1 = active, 2 = completed
\n"}]},"url":"{{url}}/connect/api/v1/event/tasks/2401/update_status","description":"You can use a sparse object to update certain fields or full object.
\n","urlObject":{"path":["connect","api","v1","event","tasks","2401","update_status"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1562c5f7-5214-494f-8f7c-b3fd144ebc67"},{"name":"Delete task","id":"45aa8c62-8c2a-4d63-bdfc-18a1c5afd580","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"url":"{{url}}/connect/api/v1/event/tasks/2401","urlObject":{"path":["connect","api","v1","event","tasks","2401"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"b4360f6e-356e-436d-88dd-df9857388b85","name":"Delete event","originalRequest":{"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"url":"{{url}}/connect/api/v1/events/997"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"delete\": true,\n \"id\": \"997\"\n}"}],"_postman_id":"45aa8c62-8c2a-4d63-bdfc-18a1c5afd580"},{"name":"List tasks","id":"28281cb0-6039-4c59-8d6f-ad961544d0ab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/event/tasks?rows_per_page=&page=&order=&search=&task_status=&customer_id=&lead_id=","urlObject":{"path":["connect","api","v1","event","tasks"],"host":["{{url}}"],"query":[{"key":"rows_per_page","value":""},{"key":"page","value":""},{"key":"order","value":""},{"key":"search","value":""},{"key":"task_status","value":""},{"description":{"content":"int, optional - list only tasks for a customer
\n","type":"text/plain"},"key":"customer_id","value":""},{"key":"lead_id","value":""}],"variable":[]}},"response":[],"_postman_id":"28281cb0-6039-4c59-8d6f-ad961544d0ab"}],"id":"8767c3af-8f4d-4820-82a2-7b18eb765cd5","event":[{"listen":"prerequest","script":{"id":"604bdec7-b73a-461b-9aee-4efd67d24ede","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"83e688b2-7549-43d1-af57-328db5ecb385","type":"text/javascript","exec":[""]}}],"_postman_id":"8767c3af-8f4d-4820-82a2-7b18eb765cd5","description":""},{"name":"Expenses","item":[{"name":"List expenses","id":"4d1204aa-6fa7-46fa-86e3-97cdebecc617","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/expenses?type=&customer_id=&date-issued=&order=&search=&page=&rows_per_page=","description":"A list of Work Order object
Pagination
int, optional - Values: 1 = normal, 2 = mileage expense
\n","type":"text/plain"},"key":"type","value":""},{"description":{"content":"int, optional - Filter by customer
\n","type":"text/plain"},"key":"customer_id","value":""},{"description":{"content":"int, optional - Filter by year or month, example year-2024 or month-2024-05
\n","type":"text/plain"},"key":"date-issued","value":""},{"description":{"content":"string, optional - Sort by name-asc, name-desc, number-asc, number-desc, date-issued-asc, date-issued-desc, priority-asc, priority-desc
\n","type":"text/plain"},"key":"order","value":""},{"description":{"content":"string, optional
\n","type":"text/plain"},"key":"search","value":""},{"description":{"content":"int, optional - Default 1
\n","type":"text/plain"},"key":"page","value":""},{"description":{"content":"int, optional - Default 20
\n","type":"text/plain"},"key":"rows_per_page","value":""}],"variable":[]}},"response":[{"id":"3e7bd164-d7e8-4c50-9f98-7eb458560097","name":"List expenses","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":{"raw":"{{url}}/connect/api/v1/expenses?type=&customer_id=&date-issued=&order=&search=&page=&rows_per_page=","host":["{{url}}"],"path":["connect","api","v1","expenses"],"query":[{"key":"type","value":"","description":"int, optional - Values: 1 = normal, 2 = mileage expense"},{"key":"customer_id","value":"","description":"int, optional - Filter by customer"},{"key":"date-issued","value":"","description":"int, optional - Filter by year or month, example year-2024 or month-2024-05"},{"key":"order","value":"","description":"string, optional - Sort by name-asc, name-desc, number-asc, number-desc, date-issued-asc, date-issued-desc, priority-asc, priority-desc"},{"key":"search","value":"","description":"string, optional"},{"key":"page","value":"","description":"int, optional - Default 1"},{"key":"rows_per_page","value":"","description":"int, optional - Default 20"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 08 Aug 2024 15:28:04 GMT"},{"key":"Server","value":"Apache/2.4.25 (Unix) LibreSSL/2.2.7 PHP/7.4.30"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:8080"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"X-Powered-By","value":"PHP/7.4.30"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"expenses\": [\n {\n \"id\": \"2620\",\n \"type\": \"2\",\n \"is_type_mileage\": true,\n \"is_type_normal\": false,\n \"customer_id\": \"73431\",\n \"customer\": {\n \"id\": \"73431\",\n \"type_service\": \"1\",\n \"display_name\": \"Jack Voe\",\n \"email\": null\n },\n \"expense_vendor_id\": \"0\",\n \"vendor\": null,\n \"work_order_id\": \"11081\",\n \"date_issued\": \"2024-07-29\",\n \"date_issued_text\": \"29-Jul-2024\",\n \"amount\": \"6.70\",\n \"tax_amount\": \"0.00\",\n \"amount_total\": \"6.70\",\n \"reference_number\": \"\",\n \"notes\": \"\",\n \"status\": \"1\",\n \"status_text\": \"Active\",\n \"url\": \"\",\n \"mileage_reading\": \"1\",\n \"mileage_start\": 0,\n \"mileage_end\": 0,\n \"mileage_distance\": 10,\n \"mileage_rate\": 0.67,\n \"items\": [],\n \"datetime_added\": \"2024-07-29T17:51:24+00:00\",\n \"datetime_updated\": \"2024-07-29T17:51:35+00:00\"\n },\n {\n \"id\": \"2619\",\n \"type\": \"1\",\n \"is_type_mileage\": false,\n \"is_type_normal\": true,\n \"customer_id\": \"73431\",\n \"customer\": {\n \"id\": \"73431\",\n \"type_service\": \"1\",\n \"display_name\": \"Jack Voe\",\n \"email\": null\n },\n \"expense_vendor_id\": \"301\",\n \"vendor\": {\n \"id\": \"301\",\n \"name\": \"Homedepot\"\n },\n \"work_order_id\": \"11081\",\n \"date_issued\": \"2024-07-29\",\n \"date_issued_text\": \"29-Jul-2024\",\n \"amount\": \"5.00\",\n \"tax_amount\": \"0.00\",\n \"amount_total\": \"5.00\",\n \"reference_number\": \"\",\n \"notes\": \"\",\n \"status\": \"1\",\n \"status_text\": \"Active\",\n \"url\": \"\",\n \"mileage_reading\": \"1\",\n \"mileage_start\": 0,\n \"mileage_end\": 0,\n \"mileage_distance\": 0,\n \"mileage_rate\": 0,\n \"items\": [\n {\n \"id\": \"2627\",\n \"expense_category_id\": \"401\",\n \"expense_category\": {\n \"id\": \"401\",\n \"name\": \"Automobile Expense\",\n \"description\": \"\",\n \"is_mileage\": \"0\"\n },\n \"name\": \"B\",\n \"qty\": 1,\n \"price\": 3,\n \"tax_percent\": 0,\n \"tax_amount\": 0,\n \"tax_rate_id\": \"0\",\n \"total\": 3,\n \"billable_status\": \"0\",\n \"billable_status_text\": \"Non-Billable\",\n \"position\": \"1\"\n }\n ],\n \"datetime_added\": \"2024-07-29T17:50:42+00:00\",\n \"datetime_updated\": \"2024-07-30T11:41:47+00:00\"\n }, \n ],\n \"pagination\": {\n \"page\": 1,\n \"next\": 2,\n \"previous\": 0,\n \"page_has_rows\": true,\n \"rows_per_page\": 20,\n \"total_rows\": \"157\",\n \"total_pages\": 8\n }\n}"}],"_postman_id":"4d1204aa-6fa7-46fa-86e3-97cdebecc617"},{"name":"Get expense","id":"f333ac91-e2b0-472a-a2cd-782f36d50dce","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/expenses/2654","urlObject":{"path":["connect","api","v1","expenses","2654"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"118b1344-2d79-40ad-aaa2-7ab19ae64d91","name":"Get expense","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/expenses/5084"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 30 May 2024 13:01:06 GMT"},{"key":"Server","value":"Apache/2.4.38 (Debian)"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"Content-Length","value":"1117"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"expense\": {\n \"id\": \"5084\",\n \"type\": \"1\",\n \"is_type_mileage\": false,\n \"is_type_normal\": true,\n \"customer_id\": \"58645\",\n \"customer\": {\n \"id\": \"58645\",\n \"type_service\": \"1\",\n \"display_name\": \"Abacus Amos\",\n \"email\": \"and.mohareb@gmail.com\"\n },\n \"expense_vendor_id\": \"163\",\n \"vendor\": {\n \"id\": \"163\",\n \"name\": \"Homedepot\"\n },\n \"work_order_id\": \"5840\",\n \"date_issued\": \"2024-05-20\",\n \"date_issued_text\": \"20-May-2024\",\n \"amount\": \"100.00\",\n \"tax_amount\": \"0.00\",\n \"amount_total\": \"100.00\",\n \"reference_number\": \"R1\",\n \"notes\": \"Please call the customer before starting the job\",\n \"status\": \"1\",\n \"status_text\": \"Active\",\n \"url\": \"https://www.markate.com/pro/expenses/main/view/id/5084\",\n \"mileage_reading\": \"0\",\n \"mileage_start\": 0,\n \"mileage_end\": 0,\n \"mileage_distance\": 0,\n \"mileage_rate\": 0,\n \"items\": [\n {\n \"id\": \"3761\",\n \"expense_category_id\": \"217\",\n \"expense_category\": {\n \"id\": \"217\",\n \"name\": \"Automobile Expense\",\n \"description\": \"\",\n \"is_mileage\": \"0\"\n },\n \"name\": \"Green paint\",\n \"qty\": 1,\n \"price\": 100,\n \"tax_percent\": 0,\n \"tax_amount\": 0,\n \"tax_rate_id\": \"0\",\n \"total\": 100,\n \"billable_status\": \"1\",\n \"billable_status_text\": \"Billable\",\n \"position\": \"0\"\n }\n ],\n \"datetime_added\": \"2024-05-30T12:05:19+00:00\",\n \"datetime_updated\": \"2024-05-30T12:08:37+00:00\"\n }\n}"}],"_postman_id":"f333ac91-e2b0-472a-a2cd-782f36d50dce"},{"name":"Create normal expense","id":"e7783219-aa39-43a4-8e8a-d8b5f1eb1f49","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"1","type":"text","description":"int, required - Type normal = 1, type mileage = 2
\n"},{"key":"date_issued","value":"2025-10-08","type":"text","description":"string, required - Expense date format yyyy-mm-dd
\n"},{"key":"expense_vendor_id","value":"303","type":"text","description":"int, optional - A valid vendor id
\n"},{"key":"customer_id","value":"14429","type":"text","description":"int, optional - Assign the expense to a customer
\n"},{"key":"work_order_id","value":"","type":"text","description":"int, optional - Link the expense to a Work Order
\n"},{"key":"employee_id","value":"","description":"int, optional - Assign the expense to an employee (track who added the expense)
\n","type":"text","uuid":"66849c9d-ddf6-4f53-927f-a606e7fc9d79"},{"key":"reference_number","value":"Ref123","type":"text","description":"string, optional
\n"},{"key":"notes","value":"Please call the customer before starting the job","type":"text","description":"string, optional
\n"},{"key":"items[0][id]","value":"0","type":"text","description":"int, required - Value id = 0 a new item line will be inserted, kept for consistentcy with update
\n"},{"key":"items[0][expense_category_id]","value":"401","type":"text","description":"int, required - An expense category
\n"},{"key":"items[0][name]","value":"Car paint","type":"text","description":"string, required
\n"},{"key":"items[0][price]","value":"100","type":"text","description":"float, required
\n"},{"key":"items[0][tax_rate_id]","value":"","type":"text","description":"int, optional
\n"},{"key":"items[0][billable_status]","value":"1","type":"text","description":"int, required - Allowed values 0 or 1
\n"}]},"url":"{{url}}/connect/api/v1/expenses","urlObject":{"path":["connect","api","v1","expenses"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"e7783219-aa39-43a4-8e8a-d8b5f1eb1f49"},{"name":"Create mileage expense","id":"a52c0301-203c-47c7-bc38-bfa7452cff85","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"2","type":"text","description":"int, required - Type normal = 1, type mileage = 2
\n"},{"key":"date_issued","value":"2024-05-20","type":"text","description":"string, required - Expense date format yyyy-mm-dd
\n"},{"key":"expense_vendor_id","value":"","type":"text","description":"int, optional - A valid vendor id
\n"},{"key":"customer_id","value":"","type":"text","description":"int, optional - Assign the expense to a customer
\n"},{"key":"work_order_id","value":"","type":"text","description":"int, optional - Link the expense to a Work Order
\n"},{"key":"employee_id","value":"","description":"int, optional - Assign the expense to an employee (track who added the expense)
\n","type":"text","uuid":"b847ecdc-9bcc-48bf-971f-a2a67d6ef4f7"},{"key":"reference_number","value":"","type":"text","description":"string, optional
\n"},{"key":"notes","value":"Please call the customer before starting the job","type":"text","description":"string, optional
\n"},{"key":"mileage_reading","value":"1","type":"text","description":"int, optional
\n"},{"key":"mileage_distance","value":"100","type":"text","description":"int, required - Allowed values 0 or 1
\n"},{"key":"mileage_start","value":"","type":"text"},{"key":"mileage_end","value":"","type":"text"},{"key":"mileage_rate","value":"2","type":"text"},{"key":"tax_rate_id","value":"","type":"text"},{"key":"billable_status","value":"1","type":"text"}]},"url":"{{url}}/connect/api/v1/expenses","urlObject":{"path":["connect","api","v1","expenses"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"a52c0301-203c-47c7-bc38-bfa7452cff85"},{"name":"Update expense","id":"0947b7c9-833a-4063-8b12-72725a84cc84","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"1","type":"text"},{"key":"date_issued","value":"2024-05-20","type":"text"},{"key":"expense_vendor_id","value":"301","type":"text"},{"key":"customer_id","value":"58645","type":"text"},{"key":"work_order_id","value":"5840","type":"text"},{"key":"employee_id","value":"","description":"int, optional - Assign the expense to an employee (track who added the expense)
\n","type":"text","uuid":"8cee22d0-3e47-49af-9820-d0ec9ea7ece8"},{"key":"reference_number","value":"R1","type":"text"},{"key":"notes","value":"Please call the customer before starting the job","type":"text"},{"key":"items[0][id]","value":"3761","type":"text","description":"int, required - If id = 0 a new item line will be inserted, else if id > 0 an existent item will be updated
\n"},{"key":"items[0][expense_category_id]","value":"217","type":"text"},{"key":"items[0][name]","value":"Green paint","type":"text"},{"key":"items[0][price]","value":"100","type":"text"},{"key":"items[0][tax_rate_id]","value":"","type":"text"},{"key":"items[0][billable_status]","value":"1","type":"text"},{"key":"","value":"","type":"text","uuid":"9496fdd8-b731-43c7-bf87-831586f0498f"}]},"url":"{{url}}/connect/api/v1/expenses/2638","description":"You can use a sparse object to update certain fields or full object.
\n","urlObject":{"path":["connect","api","v1","expenses","2638"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"0947b7c9-833a-4063-8b12-72725a84cc84"},{"name":"Delete expense","id":"ab6381c6-cab5-48c6-b054-509d64c5f7e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/expenses/2640","urlObject":{"path":["connect","api","v1","expenses","2640"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"6d1d507c-a45f-4063-9ed9-5fa7c3c37d88","name":"Delete customer","originalRequest":{"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/customers/19337"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"delete\": true,\n \"id\": \"19337\"\n}"}],"_postman_id":"ab6381c6-cab5-48c6-b054-509d64c5f7e7"}],"id":"6ca20980-50cd-4cf3-a6df-9e36afceb47d","event":[{"listen":"prerequest","script":{"id":"bb15b026-2df6-4d09-8e3c-2c6fd1347779","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"dab3e258-849c-4ac4-ad02-3ee865d84532","type":"text/javascript","exec":[""]}}],"_postman_id":"6ca20980-50cd-4cf3-a6df-9e36afceb47d","description":""},{"name":"Expense Attachments","item":[{"name":"List all attachments","id":"197d73b5-97dc-4226-b57b-dfbdd727bf81","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/expense/attachments?expense_id=2642","description":"A list of expense_attachment object. The API returns max 5 attachments for the requested expense.
\n","urlObject":{"path":["connect","api","v1","expense","attachments"],"host":["{{url}}"],"query":[{"description":{"content":"int, required - A valid expense id
\n","type":"text/plain"},"key":"expense_id","value":"2642"}],"variable":[]}},"response":[{"id":"cf8151ef-edc1-432b-b7ca-85a1b7875751","name":"List all attachments","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":{"raw":"{{url}}/connect/api/v1/expense/attachments?expense_id=2642","host":["{{url}}"],"path":["connect","api","v1","expense","attachments"],"query":[{"key":"expense_id","value":"2642","description":"int, required - A valid expense id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 08 Aug 2024 15:30:48 GMT"},{"key":"Server","value":"Apache/2.4.25 (Unix) LibreSSL/2.2.7 PHP/7.4.30"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:8080"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"X-Powered-By","value":"PHP/7.4.30"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"expense_attachments\": [\n {\n \"id\": \"460\",\n \"expense_id\": \"2642\",\n \"name_original\": \"receipt.jpg\",\n \"name_custom\": null,\n \"type\": \"image/jpeg\",\n \"extension\": \"jpg\",\n \"size\": \"4927\",\n \"encrypted\": \"0\",\n \"url\": \"https://...\",\n \"url_thumbnail\": \"https://...\", \n \"is_image\": true,\n \"position\": \"460\",\n \"datetime_added\": \"2024-08-08T15:30:20+00:00\",\n \"datetime_updated\": null\n }\n ]\n}"}],"_postman_id":"197d73b5-97dc-4226-b57b-dfbdd727bf81"},{"name":"Upload attachment","id":"5d2da98b-c3dd-4f1f-a84e-c9b4b47fcce1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":" multipart/form-data","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"File to be uploaded, using multipart/form-data protocol.
\n","type":"file","value":null}]},"url":"{{url}}/connect/api/v1/expense/attachments/upload?expense_id=2642","description":"To upload a file you need to send a request with header Content-Type: multipart/form-data. Include the file you want to upload in the request. File data is sent as sections in a multipart document in the body of the request.
\nMaximum 5 attachments can be uploaded for an expense.
\n","urlObject":{"path":["connect","api","v1","expense","attachments","upload"],"host":["{{url}}"],"query":[{"key":"expense_id","value":"2642"}],"variable":[]}},"response":[],"_postman_id":"5d2da98b-c3dd-4f1f-a84e-c9b4b47fcce1"},{"name":"Order attachments","id":"4c66e59c-d9c4-411c-b716-98b608339a07","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"id[0]","value":"450","type":"text"},{"key":"id[1]","value":"451","type":"text"},{"key":"id[2]","value":"452","type":"text"}]},"url":"{{url}}/connect/api/v1/expense/attachments/order?expense_id=2641","description":"Allows you to change the order of the attachments and how they will be displayed in expense, by sending an ordered list of the attachment ids.
\n","urlObject":{"path":["connect","api","v1","expense","attachments","order"],"host":["{{url}}"],"query":[{"key":"expense_id","value":"2641"}],"variable":[]}},"response":[],"_postman_id":"4c66e59c-d9c4-411c-b716-98b608339a07"},{"name":"Delete attachment","id":"2cc05d8e-d027-410c-930c-56d688d0794c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/expense/attachments/459?expense_id=2641","urlObject":{"path":["connect","api","v1","expense","attachments","459"],"host":["{{url}}"],"query":[{"key":"expense_id","value":"2641"}],"variable":[]}},"response":[],"_postman_id":"2cc05d8e-d027-410c-930c-56d688d0794c"}],"id":"5d1196c6-26fa-4d45-9693-c2d8c3d3ac5d","_postman_id":"5d1196c6-26fa-4d45-9693-c2d8c3d3ac5d","description":""},{"name":"Expense Categories","item":[{"name":"List all categories","id":"c067b8cd-26ee-4174-878d-e92971ca53a4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/expense/categories?search=&order=&page=&rows_per_page=","description":"A list of expense categories.
Pagination
string, required
\n"},{"key":"description","value":"Rent and other bills","type":"text","description":"string, optional
\n"}]},"url":"{{url}}/connect/api/v1/expense/categories/","urlObject":{"path":["connect","api","v1","expense","categories",""],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"115c40d5-3ab2-40a4-a39a-21f863571fe7"},{"name":"Update category","id":"4282d93e-404e-4ed5-95cc-fba446761c2c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"name","value":"Office bills","type":"text","description":"int, required - The ID of the customer
\n"},{"key":"description","value":"Rent and other bills","type":"text","description":"string, required - Street address
\n"}]},"url":"{{url}}/connect/api/v1/expense/categories/3977","urlObject":{"path":["connect","api","v1","expense","categories","3977"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"4282d93e-404e-4ed5-95cc-fba446761c2c"},{"name":"Delete category","id":"74c7a90c-1afc-4f13-a9e2-fdaaa55df583","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/expense/categories/2037","urlObject":{"path":["connect","api","v1","expense","categories","2037"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"74c7a90c-1afc-4f13-a9e2-fdaaa55df583"}],"id":"2ce6cf48-fd1a-4333-a43c-3a3a0a241c78","_postman_id":"2ce6cf48-fd1a-4333-a43c-3a3a0a241c78","description":""},{"name":"Expense Vendors","item":[{"name":"List all vendors","id":"267e746d-1a09-4d3a-98f5-d21f37775667","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/expense/vendors?search=&order=&page=&rows_per_page=","description":"A list of expense vendors.
Pagination
string, required
\n"}]},"url":"{{url}}/connect/api/v1/expense/vendors/","urlObject":{"path":["connect","api","v1","expense","vendors",""],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"6b6213d8-acac-4c24-be0f-0368600ab561"},{"name":"Update vendor","id":"8fff7348-6d07-4580-b47a-6fb2c41b40d4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"name","value":"Mike Auto Shop","type":"text","description":"int, required - The ID of the customer
\n"}]},"url":"{{url}}/connect/api/v1/expense/vendors/1550","urlObject":{"path":["connect","api","v1","expense","vendors","1550"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"8fff7348-6d07-4580-b47a-6fb2c41b40d4"},{"name":"Delete vendor","id":"48d3b0f6-3555-4b5e-aa8a-48a2d4c264ca","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/expense/vendors/1550","urlObject":{"path":["connect","api","v1","expense","vendors","1550"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"48d3b0f6-3555-4b5e-aa8a-48a2d4c264ca"}],"id":"6d8ae5fb-8ab0-4f41-80be-76d15b436458","_postman_id":"6d8ae5fb-8ab0-4f41-80be-76d15b436458","description":""},{"name":"Leads","item":[{"name":"List leads","id":"532c089d-93b9-47a9-ba1e-288045a24b42","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/leads?status=&title=&name=john&email=&phone=&search=&search_type=&order=&page=&rows_per_page=&source_type&lead_label_id&lead_stage_id&customer_source_id=","description":"A list of leads.
Pagination
int, optional - Filter by status
\n","type":"text/plain"},"key":"status","value":""},{"description":{"content":"string, optional - Match by title - exactly or fuzzy
\n","type":"text/plain"},"key":"title","value":""},{"description":{"content":"string, optional - match by name - exactly or fuzzy
\n","type":"text/plain"},"key":"name","value":"john"},{"description":{"content":"string, optional - Match by email - exactly or fuzzy
\n","type":"text/plain"},"key":"email","value":""},{"description":{"content":"string, optional - Match by phone - exactly or fuzzy
\n","type":"text/plain"},"key":"phone","value":""},{"description":{"content":"string, optional - Search by multiple fields
\n","type":"text/plain"},"key":"search","value":""},{"description":{"content":"string, optional - empty for exact match or fuzzy for fuzzy search (applied to only one field, eg title)
\n","type":"text/plain"},"key":"search_type","value":""},{"description":{"content":"string, optional - Sort by date-desc, date-asc, unread-asc, title-asc, title-desc, name-asc, name-desc, source-asc, source-desc, label-asc, label-desc
\n","type":"text/plain"},"key":"order","value":""},{"description":{"content":"int, optional - Default 1
\n","type":"text/plain"},"key":"page","value":""},{"description":{"content":"int, optional - Default 20
\n","type":"text/plain"},"key":"rows_per_page","value":""},{"description":{"content":"int, optional - Use source_type = 2 for leads and 7 for opportunity leads
\n","type":"text/plain"},"key":"source_type","value":null},{"description":{"content":"int, optional - Filter by label
\n","type":"text/plain"},"key":"lead_label_id","value":null},{"description":{"content":"int, optional - Filter by stage
\n","type":"text/plain"},"key":"lead_stage_id","value":null},{"description":{"content":"int, optional - Filter by customer source
\n","type":"text/plain"},"key":"customer_source_id","value":""}],"variable":[]}},"response":[{"id":"0e8e12e5-acec-4a67-951d-083532510724","name":"List leads","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":{"raw":"{{url}}/connect/api/v1/leads?status=&search=&order=&page=&rows_per_page=&source_type&lead_label_id&lead_stage_id&customer_source_id=","host":["{{url}}"],"path":["connect","api","v1","leads"],"query":[{"key":"status","value":"","description":"int, optional - Filter by status"},{"key":"search","value":"","description":"string, optional - Search by multiple fields"},{"key":"order","value":"","description":"string, optional - Sort by date-desc, date-asc, unread-asc, title-asc, title-desc, name-asc, name-desc, source-asc, source-desc, label-asc, label-desc"},{"key":"page","value":"","description":"int, optional - Default 1"},{"key":"rows_per_page","value":"","description":"int, optional - Default 20"},{"key":"source_type","value":null,"description":"int, optional - Use source_type = 2 for leads and 7 for opportunity leads"},{"key":"lead_label_id","value":null,"description":"int, optional - Filter by label"},{"key":"lead_stage_id","value":null,"description":"int, optional - Filter by stage"},{"key":"customer_source_id","value":"","description":"int, optional - Filter by customer source "}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 08 Aug 2024 15:35:16 GMT"},{"key":"Server","value":"Apache/2.4.25 (Unix) LibreSSL/2.2.7 PHP/7.4.30"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:8080"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"X-Powered-By","value":"PHP/7.4.30"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"leads\": [\n {\n \"id\": \"472\",\n \"customer_id\": \"0\",\n \"customer_address_id\": \"0\",\n \"work_order_id\": \"0\",\n \"lead_stage_id\": \"801\",\n \"stage\": {\n \"id\": \"801\",\n \"name\": \"New\"\n },\n \"lead_label_id\": \"303\",\n \"label\": {\n \"id\": \"303\",\n \"name\": \"Cold\",\n \"color_id\": \"20\",\n \"color_code\": \"#1991e0\"\n },\n \"title\": \"Cleaning job in Phoenix\",\n \"display_name\": \"John Doe\",\n \"name\": \"John Doe\",\n \"email\": \"email@test.com\",\n \"phone\": \"0902345348\",\n \"company\": \"Acme Inc\",\n \"address\": \"344 3rd Avenue\",\n \"address_secondary\": \"A1\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"zip\": \"10010\",\n \"latlng\": \"40.7404705,-73.9822956\",\n \"message\": null,\n \"contact_time\": null,\n \"type_service\": \"1\",\n \"notify_method_email\": \"1\",\n \"notify_method_sms\": \"1\",\n \"customer_source_id\": \"3756\",\n \"customer_source\": {\n \"id\": \"3756\",\n \"name\": \"Facebook\"\n },\n \"source\": null,\n \"source_type\": \"2\",\n \"source_type_text\": \"Manual Entry\",\n \"source_data\": null,\n \"notes\": \"Some internal notes\",\n \"employees\": [\n {\n \"id\": \"534\",\n \"first_name\": \"Boris\",\n \"last_name\": \"Becker\",\n \"is_owner\": false\n },\n {\n \"id\": \"460\",\n \"first_name\": \"Field\",\n \"last_name\": \"Tech\",\n \"is_owner\": false\n }\n ],\n \"status\": \"0\",\n \"status_text\": \"Open\",\n \"status_read\": \"1\",\n \"datetime_converted\": null,\n \"datetime_added\": \"2024-08-08T13:51:40+00:00\",\n \"datetime_updated\": null\n } \n ],\n \"paginator\": {\n \"page\": 1,\n \"next\": 2,\n \"previous\": 0,\n \"page_has_rows\": true,\n \"rows_per_page\": 20,\n \"total_rows\": \"375\",\n \"total_pages\": 19\n }\n}"}],"_postman_id":"532c089d-93b9-47a9-ba1e-288045a24b42"},{"name":"Get lead","id":"1c2802c7-0675-497d-8205-3b44ed91b4cb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/leads/753","urlObject":{"path":["connect","api","v1","leads","753"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"24224463-38c0-4f48-b7a0-b07bcad266f2","name":"Get lead","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/leads/472"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 08 Aug 2024 15:36:04 GMT"},{"key":"Server","value":"Apache/2.4.25 (Unix) LibreSSL/2.2.7 PHP/7.4.30"},{"key":"X-Powered-By","value":"PHP/7.4.30"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"lead\": {\n \"id\": \"472\",\n \"customer_id\": \"0\",\n \"customer_address_id\": \"0\",\n \"work_order_id\": \"0\",\n \"lead_stage_id\": \"801\",\n \"stage\": {\n \"id\": \"801\",\n \"name\": \"New\"\n },\n \"lead_label_id\": \"303\",\n \"label\": {\n \"id\": \"303\",\n \"name\": \"Cold\",\n \"color_id\": \"20\",\n \"color_code\": \"#1991e0\"\n },\n \"title\": \"Cleaning job in Phoenix\",\n \"display_name\": \"John Doe\",\n \"name\": \"John Doe\",\n \"email\": \"email@test.com\",\n \"phone\": \"0902345348\",\n \"company\": \"Acme Inc\",\n \"address\": \"344 3rd Avenue\",\n \"address_secondary\": \"A1\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"zip\": \"10010\",\n \"latlng\": \"40.7404705,-73.9822956\",\n \"message\": null,\n \"contact_time\": null,\n \"type_service\": \"1\",\n \"notify_method_email\": \"1\",\n \"notify_method_sms\": \"1\",\n \"customer_source_id\": \"3756\",\n \"customer_source\": {\n \"id\": \"3756\",\n \"name\": \"Facebook\"\n },\n \"source\": null,\n \"source_type\": \"2\",\n \"source_type_text\": \"Manual Entry\",\n \"source_data\": null,\n \"notes\": \"Some internal notes\",\n \"employees\": [\n {\n \"id\": \"534\",\n \"first_name\": \"Boris\",\n \"last_name\": \"Becker\",\n \"is_owner\": false\n },\n {\n \"id\": \"460\",\n \"first_name\": \"Field\",\n \"last_name\": \"Tech\",\n \"is_owner\": false\n }\n ],\n \"status\": \"0\",\n \"status_text\": \"Open\",\n \"status_read\": \"1\",\n \"datetime_converted\": null,\n \"datetime_added\": \"2024-08-08T13:51:40+00:00\",\n \"datetime_updated\": null\n }\n}"}],"_postman_id":"1c2802c7-0675-497d-8205-3b44ed91b4cb"},{"name":"Create lead","id":"2c77820b-0ada-43b8-9773-6f65207e2262","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"title","value":"Cleaning job in Phoenix","type":"text","description":"string, required - The lead title
\n"},{"key":"type_service","value":"1","type":"text","description":"int, required - 1 for residential, 2 for commercial
\n"},{"key":"name","value":"John Doe","type":"text","description":"string, required - customer full name
\n"},{"key":"phone","value":"(090) 234-5348","type":"text","description":"string, required
\n"},{"key":"phone_secondary","value":"(423) 534-5345","type":"text","description":"string, optional
\n"},{"key":"email","value":"email@test.com","type":"text","description":"string, optional
\n"},{"key":"notify_method_email","value":"1","type":"text","description":"int, required - allowed values 1 or 0
\n"},{"key":"notify_method_sms","value":"1","type":"text","description":"int, required - allowed values 1 or 0
\n"},{"key":"company","value":"Acme Inc","type":"text","description":"string, optional
\n"},{"key":"address","value":"344 3rd Avenue","type":"text","description":"string, optional
\n"},{"key":"address_secondary","value":"A1","type":"text","description":"string, optional
\n"},{"key":"city","value":"New York","type":"text","description":"string, optional
\n"},{"key":"zip","value":"10010","type":"text","description":"string, optional
\n"},{"key":"state","value":"NY","type":"text","description":"string, optional
\n"},{"key":"latlng","value":"40.7404705,-73.9822956","type":"text","description":"string, optional
\n"},{"key":"customer_source_id","value":"3756","type":"text","description":"int, optional
\n"},{"key":"lead_label_id","value":"303","type":"text","description":"int, optional - see Leads Labels endpoint
\n"},{"key":"notes","value":"Some internal notes","type":"text","description":"string, optional
\n"},{"key":"employee_id[]","value":"534","type":"text","description":"int[], optional - assign the lead to employees
\n"},{"key":"employee_id[]","value":"460","type":"text"}]},"url":"{{url}}/connect/api/v1/leads","urlObject":{"path":["connect","api","v1","leads"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"2c77820b-0ada-43b8-9773-6f65207e2262"},{"name":"Create lead opportunity","id":"d0cf8fde-183c-4e85-a7d2-dbc1810d8c58","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"source_type","value":"7","type":"text","description":"int, required - set source_type = 7 for opportunity lead
\n"},{"key":"title","value":"Garage Door Install in Phoenix","type":"text","description":"string, required - the lead title
\n"},{"key":"customer_id","value":"33855","type":"text","description":"int, required - a valid customer id
\n"},{"key":"customer_address_id","value":"-1","type":"text","description":"int, optional - a customer address, -1 for primary address else a valid customer address id
\n"},{"key":"customer_source_id","value":"","type":"text","description":"int, optional
\n"},{"key":"lead_label_id","value":"301","type":"text","description":"int, optional
\n"},{"key":"source","value":"Recommended by David","type":"text","description":"string, optional - source text
\n"},{"key":"notes","value":"Requested a garage door install","type":"text","description":"string, otional - internal notes
\n"}]},"url":"{{url}}/connect/api/v1/leads","description":"An opportunity lead is a lead for an existent customer and requires a customer_id.
\n","urlObject":{"path":["connect","api","v1","leads"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"d0cf8fde-183c-4e85-a7d2-dbc1810d8c58"},{"name":"Update lead","id":"eb2d5b56-5fac-4f03-a0de-133a912c70e3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"title","value":"Cleaning job in Phoenix","type":"text"},{"key":"type_service","value":"1","type":"text"},{"key":"name","value":"John Doe","type":"text"},{"key":"phone","value":"(090) 234-5348","type":"text"},{"key":"phone_secondary","value":"(423) 534-5345","type":"text"},{"key":"email","value":"email@test.com","type":"text"},{"key":"notify_method_email","value":"1","type":"text"},{"key":"notify_method_sms","value":"1","type":"text"},{"key":"company","value":"Acme Inc","type":"text"},{"key":"address","value":"344 3rd Avenue","type":"text"},{"key":"address_secondary","value":"A1","type":"text"},{"key":"city","value":"New York","type":"text"},{"key":"zip","value":"10010","type":"text"},{"key":"state","value":"NY","type":"text"},{"key":"latlng","value":"40.7404705,-73.9822956","type":"text"},{"key":"customer_source_id","value":"3756","type":"text"},{"key":"lead_label_id","value":"303","type":"text"},{"key":"notes","value":"Some internal notes","type":"text"},{"key":"employee_id[]","value":"534","type":"text"},{"key":"employee_id[]","value":"460","type":"text"}]},"url":"{{url}}/connect/api/v1/leads/473","description":"You can use a sparse object to update certain fields or full object.
\n","urlObject":{"path":["connect","api","v1","leads","473"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"eb2d5b56-5fac-4f03-a0de-133a912c70e3"},{"name":"Update status to won","id":"95147b10-0f19-45c1-bb03-cfdfbc67f91a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"notes","value":"Customer accepted the estimate","type":"text","description":"string, optional - insternal notes on mark lead as won
\n"}]},"url":"{{url}}/connect/api/v1/leads/472/update_status_to_won","description":"Mark the lead as won.
\n","urlObject":{"path":["connect","api","v1","leads","472","update_status_to_won"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"11d3f85e-2dbd-4337-9f88-493e064ca45c","name":"Update status to won","originalRequest":{"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"notes","value":"Customer accepted the estimate","type":"text","description":"string, optional - insternal notes on mark lead as won"}]},"url":"{{url}}/connect/api/v1/leads/472/update_status_to_won"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 08 Aug 2024 15:36:52 GMT"},{"key":"Server","value":"Apache/2.4.25 (Unix) LibreSSL/2.2.7 PHP/7.4.30"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:8080"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"X-Powered-By","value":"PHP/7.4.30"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"472\",\n \"update_status_to_won\": true\n}"}],"_postman_id":"95147b10-0f19-45c1-bb03-cfdfbc67f91a"},{"name":"Update status to lost","id":"6cb5c706-d469-4fc4-8dde-c214644fd1ff","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"status","value":"2","type":"text","description":"int, required - Allowed values Lost = 2, Postponed = 7, Unqualified = 9
\n"},{"key":"notes","value":"Customer declined the estimate","type":"text","description":"string, optional - Internal notes
\n"}]},"url":"{{url}}/connect/api/v1/leads/470/update_status_to_lost","description":"Mark the lead as lost requires to specify one of the lost statuses.
\n","urlObject":{"path":["connect","api","v1","leads","470","update_status_to_lost"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"6cb5c706-d469-4fc4-8dde-c214644fd1ff"},{"name":"Update status to open","id":"59be2276-93c4-408b-a69d-d85cc4e3898a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"{{url}}/connect/api/v1/leads/470/update_status_to_open","description":"Reopen a won or lost lead.
\n","urlObject":{"path":["connect","api","v1","leads","470","update_status_to_open"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"59be2276-93c4-408b-a69d-d85cc4e3898a"},{"name":"Update stage","id":"ffa2f487-d152-4ff8-bd65-2ae80174a25a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"lead_stage_id","value":"802","description":"int, required - A valid lead stage id
\n","type":"text"}]},"url":"{{url}}/connect/api/v1/leads/472/update_stage","description":"Move the lead to a pipeline stage.
\n","urlObject":{"path":["connect","api","v1","leads","472","update_stage"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"420b4d69-49ae-4d25-9d45-22657a305b0b","name":"Update stage","originalRequest":{"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"lead_stage_id","value":"802","description":"int, required - A valid lead stage id ","type":"text"}]},"url":"{{url}}/connect/api/v1/leads/472/update_stage"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 08 Aug 2024 15:37:14 GMT"},{"key":"Server","value":"Apache/2.4.25 (Unix) LibreSSL/2.2.7 PHP/7.4.30"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:8080"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"X-Powered-By","value":"PHP/7.4.30"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"472\",\n \"update_stage\": true\n}"}],"_postman_id":"ffa2f487-d152-4ff8-bd65-2ae80174a25a"},{"name":"Delete lead","id":"93a4e61b-5d66-427c-b2d8-5d4d01975d1a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/leads/473","urlObject":{"path":["connect","api","v1","leads","473"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"93a4e61b-5d66-427c-b2d8-5d4d01975d1a"},{"name":"Convert lead to customer","id":"578355f5-bbba-49cc-b426-137cf760c5fd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"customer_check","value":"1","type":"text","description":"int, optional - Check if a customer exists without creating a customer from lead in order to display an alert
\n"}]},"url":"{{url}}/connect/api/v1/leads/718/convert_to_customer","description":"You can use a sparse object to update certain fields or full object.
\n","urlObject":{"path":["connect","api","v1","leads","718","convert_to_customer"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"5d670129-a5df-4e79-848c-98f2f83bb0d1","name":"Convert lead to pending customer","originalRequest":{"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"customer_check","value":"1","type":"text","description":"int, optional - Check if a customer exists without creating a customer from lead in order to display an alert"}]},"url":"{{url}}/connect/api/v1/leads/718/convert_to_customer"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 13 Oct 2025 15:13:59 GMT"},{"key":"Server","value":"Apache/2.4.62 (Debian)"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"X-Powered-By","value":"PHP/7.4.33"},{"key":"Content-Length","value":"163"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"lead_id\": \"718\",\n \"customer_id\": \"74067\",\n \"convert_to_customer\": false,\n \"message\": \"We found that a customer \\\"Jackie Jones\\\" with the phone 0920423042 already exists.\"\n}"}],"_postman_id":"578355f5-bbba-49cc-b426-137cf760c5fd"}],"id":"379a4bf6-944f-4ac8-81c6-cce9af19b9df","event":[{"listen":"prerequest","script":{"id":"bb15b026-2df6-4d09-8e3c-2c6fd1347779","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"dab3e258-849c-4ac4-ad02-3ee865d84532","type":"text/javascript","exec":[""]}}],"_postman_id":"379a4bf6-944f-4ac8-81c6-cce9af19b9df","description":""},{"name":"Lead Attachments","item":[{"name":"List all attachments","id":"4ec77fc4-8a56-4457-9c04-488036b49293","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/lead/attachments?lead_id=759&page=&rows_per_page=","description":"A list of lead_attachment object.
\n","urlObject":{"path":["connect","api","v1","lead","attachments"],"host":["{{url}}"],"query":[{"key":"lead_id","value":"759"},{"description":{"content":"int, optional - Default 1
\n","type":"text/plain"},"key":"page","value":""},{"description":{"content":"int, optional - Default 20
\n","type":"text/plain"},"key":"rows_per_page","value":""}],"variable":[]}},"response":[{"id":"1da06804-859c-4232-a399-2108da7555de","name":"List all attachments","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":{"raw":"{{url}}/connect/api/v1/lead/attachments?lead_id=759","host":["{{url}}"],"path":["connect","api","v1","lead","attachments"],"query":[{"key":"lead_id","value":"759"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Thu, 07 May 2026 15:51:02 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/7.4.33"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"lead_attachments\": [\n {\n \"id\": \"678\",\n \"lead_id\": \"759\",\n \"name_original\": \"cabinet.jpg\",\n \"name_custom\": \"Cabinet\",\n \"type\": \"image/jpeg\",\n \"extension\": \"jpg\",\n \"size\": \"30964\",\n \"encrypted\": \"0\",\n \"url\": \"https://...\",\n \"url_thumbnail\": \"https://...\", \n \"is_image\": true,\n \"datetime_added\": \"2026-05-07T15:41:11+00:00\",\n \"datetime_updated\": \"2026-05-07T15:41:14+00:00\"\n }\n ]\n}"}],"_postman_id":"4ec77fc4-8a56-4457-9c04-488036b49293"},{"name":"Upload attachment","id":"5c6d2df8-8f3c-408b-968c-1632ccfc1329","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":" multipart/form-data","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"File to be uploaded, using multipart/form-data protocol.
\n","type":"file","value":null}]},"url":"{{url}}/connect/api/v1/lead/attachments/upload?lead_id=759","description":"To upload a file you need to send a request with header Content-Type: multipart/form-data. Include the file you want to upload in the request. File data is sent as sections in a multipart document in the body of the request.
\n","urlObject":{"path":["connect","api","v1","lead","attachments","upload"],"host":["{{url}}"],"query":[{"key":"lead_id","value":"759"}],"variable":[]}},"response":[],"_postman_id":"5c6d2df8-8f3c-408b-968c-1632ccfc1329"},{"name":"Delete attachment","id":"b8176396-c27a-47e8-9dd7-a3b483913f1d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/lead/attachments/680?lead_id=759","urlObject":{"path":["connect","api","v1","lead","attachments","680"],"host":["{{url}}"],"query":[{"key":"lead_id","value":"759"}],"variable":[]}},"response":[],"_postman_id":"b8176396-c27a-47e8-9dd7-a3b483913f1d"}],"id":"aba18391-ccb5-4a3f-a20c-c846378a8717","_postman_id":"aba18391-ccb5-4a3f-a20c-c846378a8717","description":""},{"name":"Lead Labels","item":[{"name":"List all labels","id":"ecf93dc4-91b0-47e3-8b40-beb12a33392c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/lead/labels","description":"A list of lead labels.
\n","urlObject":{"path":["connect","api","v1","lead","labels"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"898bdec5-5c1b-4320-bd50-92b867d261d8","name":"List all labels","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/lead/labels"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 08 Aug 2024 15:38:01 GMT"},{"key":"Server","value":"Apache/2.4.25 (Unix) LibreSSL/2.2.7 PHP/7.4.30"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:8080"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"X-Powered-By","value":"PHP/7.4.30"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"lead_labels\": [\n {\n \"id\": \"301\",\n \"name\": \"Hot\",\n \"color_id\": \"12\",\n \"color_code\": \"#efb83c\",\n \"position\": \"1\",\n \"is_default\": \"1\"\n },\n {\n \"id\": \"302\",\n \"name\": \"Warm\",\n \"color_id\": \"1\",\n \"color_code\": \"#4cb052\",\n \"position\": \"2\",\n \"is_default\": \"0\"\n },\n {\n \"id\": \"303\",\n \"name\": \"Cold\",\n \"color_id\": \"20\",\n \"color_code\": \"#1991e0\",\n \"position\": \"3\",\n \"is_default\": \"0\"\n }, \n ]\n}"}],"_postman_id":"ecf93dc4-91b0-47e3-8b40-beb12a33392c"}],"id":"3afd569e-527a-4cb9-b302-b5296efafc25","_postman_id":"3afd569e-527a-4cb9-b302-b5296efafc25","description":""},{"name":"Lead Stages","item":[{"name":"List all stages","id":"db0cca34-56cb-4cd7-bc5e-1ecb12808a38","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/lead/stages","description":"A list of expense stages
\n","urlObject":{"path":["connect","api","v1","lead","stages"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"6f79d6d0-28e1-4a4c-ba03-09d5d8d030e4","name":"List all stages","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/lead/stages"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 08 Aug 2024 15:37:22 GMT"},{"key":"Server","value":"Apache/2.4.25 (Unix) LibreSSL/2.2.7 PHP/7.4.30"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:8080"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"X-Powered-By","value":"PHP/7.4.30"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"lead_stages\": [\n {\n \"id\": \"801\",\n \"name\": \"New\",\n \"position\": \"1\"\n },\n {\n \"id\": \"802\",\n \"name\": \"Assigned\",\n \"position\": \"2\"\n },\n {\n \"id\": \"803\",\n \"name\": \"Attempted to contact\",\n \"position\": \"3\"\n },\n {\n \"id\": \"804\",\n \"name\": \"Contacted\",\n \"position\": \"4\"\n },\n {\n \"id\": \"805\",\n \"name\": \"Estimation\",\n \"position\": \"5\"\n } \n ]\n}"}],"_postman_id":"db0cca34-56cb-4cd7-bc5e-1ecb12808a38"}],"id":"455fee34-ef1f-428f-8be9-ba32adae78ba","_postman_id":"455fee34-ef1f-428f-8be9-ba32adae78ba","description":""},{"name":"Inventory Items","item":[{"name":"List all items","id":"fc4eba4c-6c1a-4395-b269-80f2b9f99a48","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/inventory_items?search=&order=&page=&rows_per_page=","description":"A list items.
\n","urlObject":{"path":["connect","api","v1","inventory_items"],"host":["{{url}}"],"query":[{"key":"search","value":""},{"key":"order","value":""},{"key":"page","value":""},{"key":"rows_per_page","value":""}],"variable":[]}},"response":[],"_postman_id":"fc4eba4c-6c1a-4395-b269-80f2b9f99a48"},{"name":"Get item","id":"99f876d3-4b6d-4e06-95f3-6d07918de7ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/inventory_items/2064","urlObject":{"path":["connect","api","v1","inventory_items","2064"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"69b6fc8c-7aad-4a76-89db-f499d031fb68","name":"Get item","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/inventory_items/2064"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 30 May 2024 12:10:19 GMT"},{"key":"Server","value":"Apache/2.4.38 (Debian)"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"Content-Length","value":"628"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"inventory_item\": {\n \"id\": \"2064\",\n \"name\": \"Gutter Cleaning\",\n \"description\": \"Gutter Cleaning & Brightening - Two Story\",\n \"item_type\": \"1\",\n \"item_type_text\": \"Service\",\n \"price\": \"100.00\",\n \"price_purchase\": \"80.00\",\n \"discount_type\": \"1\",\n \"discount_percent\": \"10.00\",\n \"discount_amount\": \"10.00\",\n \"url\": \"https://www.markate.com\",\n \"notes\": \"Cleaning job\",\n \"image\": {\n \"name\": null,\n \"name_hash\": null,\n \"url_or\": \"https://www.markate.com/assets/images/app/pro/estimates/items/nopic_sm.jpg\",\n \"url_sm\": \"https://www.markate.com/assets/images/app/pro/estimates/items/nopic_sm.jpg\"\n },\n \"datetime_added\": \"2024-05-30T12:10:13+00:00\",\n \"datetime_updated\": null\n }\n}"}],"_postman_id":"99f876d3-4b6d-4e06-95f3-6d07918de7ae"},{"name":"Create item","id":"cce17786-9722-491d-a0ae-473e2ae1fc63","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"name","value":"Gutter Cleaning","type":"text","description":"string, required - Item name
\n"},{"key":"price","value":"100","type":"text","description":"float, required - Item price
\n"},{"key":"description","value":"Gutter Cleaning & Brightening - Two Story","type":"text","description":"string, optional
\n"},{"key":"item_type","value":"1","type":"text","description":"int, optional - If set allowed values are 1 = Service, 2 = Product, 3 = Material
\n"},{"key":"price_purchase","value":"80","type":"text","description":"float, optional - The item cost (purchase price)
\n"},{"key":"tax_rate_id","value":"","description":"int, optional - set a tax rate for this item
\n","type":"text","uuid":"96baefb1-6d8e-4f3f-b497-8d47afb17f8d"},{"key":"tax_status","value":"","description":"int, optional - allowed values 1 = item is taxable, 2 = item is non-taxable, if not set it will default to value = 1 = taxable
\n","type":"text","uuid":"3e6d464c-5f88-4590-bc18-fcb7a8245eb1"},{"key":"discount_type","value":"1","type":"text","description":"int, optional - allowed values 1 = Discount Percent, 2 = Discount Amount
\n"},{"key":"discount_percent","value":"10","type":"text","description":"string, optional - required if discount percent is set
\n"},{"key":"discount_amount","value":"","type":"text","description":"float, optional - required if discount amount is set
\n"},{"key":"url","value":"https://www.markate.com","type":"text","description":"string, optional - Item link/url
\n"},{"key":"notes","value":"Cleaning job","type":"text","description":"string, optional
\n"}]},"url":"{{url}}/connect/api/v1/inventory_items/","urlObject":{"path":["connect","api","v1","inventory_items",""],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"cce17786-9722-491d-a0ae-473e2ae1fc63"},{"name":"Update item","id":"3ff3d052-8510-49b1-a92d-6f506aedd107","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"name","value":"Gutter Cleaning Spring","type":"text","description":"int, required - The ID of the customer
\n"},{"key":"price","value":"100","type":"text","description":"string, required - Street address
\n"},{"key":"description","value":"Gutter Cleaning & Brightening - Two Story","type":"text","description":"string, optional - Suite/Unit
\n"},{"key":"item_type","value":"1","type":"text","description":"string, optional - Access Code (e.g. gate code, door or lockbox code)
\n"},{"key":"price_purchase","value":"80","type":"text","description":"string, optional
\n"},{"key":"tax_rate_id","value":"","type":"text","description":"string, optional
\n"},{"key":"tax_status","value":"","type":"text","description":"string, optional
\n"},{"key":"discount_type","value":"1","type":"text","description":"string, optional
\n"},{"key":"discount_percent","value":"10","type":"text","description":"string, optional - Contact Name (e.g. tenant or occupant name)
\n"},{"key":"discount_amount","value":"","type":"text","description":"string, optional
\n"},{"key":"url","value":"https://www.markate.com","type":"text"},{"key":"notes","value":"Cleaning job","type":"text"}]},"url":"{{url}}/connect/api/v1/inventory_items/3844","urlObject":{"path":["connect","api","v1","inventory_items","3844"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"3ff3d052-8510-49b1-a92d-6f506aedd107"},{"name":"Delete item","id":"f33b89b4-305e-492f-b6af-9407e346b199","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/inventory_items/3666","urlObject":{"path":["connect","api","v1","inventory_items","3666"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"f33b89b4-305e-492f-b6af-9407e346b199"}],"id":"8f2cd58e-75b4-4f0d-90ad-79087bafc6f7","_postman_id":"8f2cd58e-75b4-4f0d-90ad-79087bafc6f7","description":""},{"name":"Invoices","item":[{"name":"List invoices","id":"ae97c82c-9f0d-40c0-9d9c-3f91221aa93a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/invoices?customer_id=&status=&search=&order=&page=&rows_per_page=50","description":"A list of Invoice object
Pagination
int, optional - List all invoices for a customer
\n","type":"text/plain"},"key":"customer_id","value":""},{"description":{"content":"string, optional - Filter by status, use a letter for each status: due D, overdue O, partial paid T, paid P, draft K. Also you can send multile statuses separated by comma eg. D, O for due + overdue
\n","type":"text/plain"},"key":"status","value":""},{"description":{"content":"string, optional - Search in multiple fields
\n","type":"text/plain"},"key":"search","value":""},{"description":{"content":"int, optional - Allowed values: added-asc, added-desc, number-asc, number-desc,amount-asc, amount-desc
\n","type":"text/plain"},"key":"order","value":""},{"key":"page","value":""},{"description":{"content":"int, optional - Default 20
\n","type":"text/plain"},"key":"rows_per_page","value":"50"}],"variable":[]}},"response":[],"_postman_id":"ae97c82c-9f0d-40c0-9d9c-3f91221aa93a"},{"name":"Get invoice","id":"cf43d46c-99e6-48a4-8228-aa8f8a08d794","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/invoices/5984","urlObject":{"path":["connect","api","v1","invoices","5984"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"57e5eb20-a31e-47bd-9d0e-81172ea4c99b","name":"Get invoice","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/invoices/5780"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 30 May 2024 13:02:46 GMT"},{"key":"Server","value":"Apache/2.4.38 (Debian)"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"Content-Length","value":"1596"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"invoice\": {\n \"id\": \"5780\",\n \"customer_id\": \"58645\",\n \"customer\": {\n \"id\": \"58645\",\n \"name\": \"Abacus Amos\"\n },\n \"customer_address_id\": \"-1\",\n \"estimate_id\": \"0\",\n \"work_order_id\": \"0\",\n \"work_order_custom_number\": \"\",\n \"custom_number\": \"INV-01566\",\n \"custom_job_title\": \"\",\n \"purchase_order_number\": \"\",\n \"type\": \"1\",\n \"type_text\": \"Deposit\",\n \"quantity_type\": 0,\n \"quantity_type_text\": \"Qty\",\n \"item_list_type\": \"1\",\n \"date_issued\": \"2024-05-20 00:00:00\",\n \"date_issued_text\": \"20-May-2024\",\n \"date_expire\": \"2024-05-27 00:00:00\",\n \"date_expire_text\": \"27-May-2024\",\n \"subtotal\": \"100.00\",\n \"subtotal_text\": \"$100.00\",\n \"adjustment_name\": \"\",\n \"adjustment_type\": \"1\",\n \"adjustment_total\": \"0.00\",\n \"adjustment_total_text\": \"$0.00\",\n \"adjustment_percent\": \"0.00\",\n \"total\": \"100.00\",\n \"total_text\": \"$100.00\",\n \"total_due\": \"100.00\",\n \"total_due_text\": \"$100.00\",\n \"total_paid\": \"0.00\",\n \"total_paid_text\": \"$0.00\",\n \"message\": \"\",\n \"terms\": \"\",\n \"payment_methods\": [\n \"cc\",\n \"cash\"\n ],\n \"viewed\": 0,\n \"viewed_datetime\": null,\n \"viewed_text\": \"\",\n \"email_data\": null,\n \"status\": \"K\",\n \"status_text\": \"Draft\",\n \"datetime_added\": \"2024-05-30T12:11:37+00:00\",\n \"datetime_updated\": null,\n \"items\": [\n {\n \"id\": \"8561\",\n \"inventory_item_id\": null,\n \"type\": \"1\",\n \"type_text\": \"Service\",\n \"name\": \"Cleaning\",\n \"description\": \"\",\n \"qty\": \"1.00\",\n \"price\": \"100.00\",\n \"price_purchase\": null,\n \"discount_type\": \"1\",\n \"discount_percent\": \"0.00\",\n \"discount_amount\": \"0.00\",\n \"tax_percent\": 0,\n \"tax_amount\": \"0.00\",\n \"tax_rate_id\": \"0\",\n \"total\": \"100.00\",\n \"image\": {\n \"name\": null,\n \"name_hash\": null,\n \"url_or\": \"https://www.markate.com/assets/images/app/pro/estimates/items/nopic_sm.jpg\",\n \"url_sm\": \"https://www.markate.com/assets/images/app/pro/estimates/items/nopic_sm.jpg\"\n },\n \"position\": \"0\"\n }\n ]\n }\n}"}],"_postman_id":"cf43d46c-99e6-48a4-8228-aa8f8a08d794"},{"name":"Get invoices config","id":"db1b4ee2-6963-43f0-a78c-4d07b5a45098","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/invoices/config","urlObject":{"path":["connect","api","v1","invoices","config"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"0e835b90-6461-4e02-8ecc-bb451facd5bf","name":"Get invoices config","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/invoices/config"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 13 Oct 2025 15:40:34 GMT"},{"key":"Server","value":"Apache/2.4.62 (Debian)"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"X-Powered-By","value":"PHP/7.4.33"},{"key":"Content-Length","value":"3004"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"invoice_config\": {\n \"next_custom_number\": [\n \"INV-\",\n \"01726\"\n ],\n \"due_terms\": \"net7\",\n \"due_terms_commercial\": \"endofmonth\",\n \"message\": \"invoice message res\",\n \"message_commercial\": \"invoice message commercial\",\n \"terms\": \"invoice terms res\",\n \"terms_commercial\": \"invoice terms commercial\",\n \"payment_to\": \"\",\n \"payment_methods\": [\n \"cc\",\n \"ach\",\n \"credit\",\n \"deposit\",\n \"paypal\",\n \"venmo\",\n \"zelle\"\n ],\n \"payment_methods_data\": [\n {\n \"id\": \"cc\",\n \"name\": \"Credit Card\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"check\",\n \"name\": \"Check\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"cash\",\n \"name\": \"Cash\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"ach\",\n \"name\": \"ACH Bank Transfer\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"credit\",\n \"name\": \"Credit Note/E-Gift Card\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"deposit\",\n \"name\": \"Direct Deposit\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"paypal\",\n \"name\": \"PayPal\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"venmo\",\n \"name\": \"Venmo\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"zelle\",\n \"name\": \"Zelle\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"cash-app\",\n \"name\": \"Cash App\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"financing\",\n \"name\": \"Consumer Financing\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"other\",\n \"name\": \"Other\",\n \"active\": true,\n \"selected\": false\n }\n ]\n },\n \"invoice_empty\": {\n \"type\": 4,\n \"custom_job_title\": \"\",\n \"custom_number\": \"INV-01726\",\n \"work_order_custom_number\": \"\",\n \"purchase_order_number\": \"\",\n \"date_expire\": \"2025-10-20\",\n \"date_expire_text\": \"20-Oct-2025\",\n \"date_expire_commercial\": \"2025-10-31\",\n \"date_expire_commercial_text\": \"31-Oct-2025\",\n \"date_issued\": \"2025-10-13\",\n \"date_issued_text\": \"13-Oct-2025\",\n \"date_issued_text_passed\": \"Today\",\n \"subtotal\": 0,\n \"adjustment_name\": \"\",\n \"adjustment_total\": 0,\n \"adjustment_type\": 1,\n \"adjustment_percent\": 0,\n \"total\": 0,\n \"message\": \"invoice message res\",\n \"terms\": \"invoice terms res\",\n \"status\": \"K\",\n \"status_text\": \"Draft\",\n \"payment_methods\": [\n \"cc\",\n \"ach\",\n \"credit\",\n \"deposit\",\n \"paypal\",\n \"venmo\",\n \"zelle\"\n ],\n \"payment_methods_data\": [\n {\n \"id\": \"cc\",\n \"name\": \"Credit Card\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"check\",\n \"name\": \"Check\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"cash\",\n \"name\": \"Cash\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"ach\",\n \"name\": \"ACH Bank Transfer\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"credit\",\n \"name\": \"Credit Note/E-Gift Card\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"deposit\",\n \"name\": \"Direct Deposit\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"paypal\",\n \"name\": \"PayPal\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"venmo\",\n \"name\": \"Venmo\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"zelle\",\n \"name\": \"Zelle\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"cash-app\",\n \"name\": \"Cash App\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"financing\",\n \"name\": \"Consumer Financing\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"other\",\n \"name\": \"Other\",\n \"active\": true,\n \"selected\": false\n }\n ]\n },\n \"invoice_type\": {\n \"1\": \"Deposit\",\n \"2\": \"Partial Payment\",\n \"3\": \"Final Payment\",\n \"4\": \"Total Due\"\n },\n \"item_type\": {\n \"1\": \"Service\",\n \"2\": \"Material\",\n \"3\": \"Product\"\n },\n \"quantity_types\": {\n \"0\": \"Qty\",\n \"1\": \"Hours\",\n \"2\": \"Sq ft\",\n \"3\": \"Rooms\",\n \"4\": \"Lin ft\"\n },\n \"tax_rate\": {\n \"id\": \"39\",\n \"name\": \"Local Tax\",\n \"rate\": 13,\n \"rate_text\": \"13%\",\n \"is_default\": \"1\"\n },\n \"payment_cc_active\": [\n \"Square\",\n \"Wisetack\",\n \"Stripe\"\n ]\n}"}],"_postman_id":"db1b4ee2-6963-43f0-a78c-4d07b5a45098"},{"name":"Create invoice","id":"6145ae23-a433-41df-a459-a8d20ab3f195","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"customer_id","value":"14429","type":"text","description":"int, required
\n"},{"key":"customer_address_id","value":"-1","description":"int, optional - If -1 will set the location as customer location, else if > 0 a valid customer_address_id is required
\n","type":"text"},{"key":"type","value":"1","type":"text","description":"int, required - Invoice Type
\n"},{"key":"custom_number","value":"INV-01566","type":"text","description":"string, conditionally required - On create if empty the system will auto-generate next number, also you can use invoices/config endpoint to get the next number, or set your own number
\n"},{"key":"custom_job_title","value":"","type":"text","description":"string, optional
\n"},{"key":"work_order_custom_number","value":"","type":"text","description":"string, optional
\n"},{"key":"purchase_order_number","value":"","type":"text","description":"string, optional
\n"},{"key":"date_issued","value":"2024-05-20","type":"text","description":"string, required
\n"},{"key":"date_expire","value":"2024-05-27","type":"text","description":"string, required
\n"},{"key":"quantity_type","value":"","type":"text"},{"key":"adjustment_name","value":"","type":"text"},{"key":"adjustment_type","value":"1","type":"text"},{"key":"adjustment_total","value":"","type":"text"},{"key":"adjustment_percent","value":"","type":"text"},{"key":"message","value":"","type":"text"},{"key":"terms","value":"","type":"text"},{"key":"payment_methods[0]","value":"cc","type":"text"},{"key":"payment_methods[1]","value":"cash","type":"text"},{"key":"items[0][id]","value":"0","type":"text"},{"key":"items[0][type]","value":"1","type":"text"},{"key":"items[0][name]","value":"Cleaning","type":"text"},{"key":"items[0][description]","value":"","type":"text"},{"key":"items[0][price]","value":"100","type":"text"},{"key":"items[0][qty]","value":"1","type":"text"},{"key":"items[0][tax_percent]","value":"","type":"text"},{"key":"items[0][tax_rate_id]","value":"","type":"text"},{"key":"items[0][discount_type]","value":"1","type":"text"},{"key":"items[0][discount_amount]","value":"","type":"text"},{"key":"items[0][discount_percent]","value":"","type":"text"}]},"url":"{{url}}/connect/api/v1/invoices","urlObject":{"path":["connect","api","v1","invoices"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"6145ae23-a433-41df-a459-a8d20ab3f195"},{"name":"Update invoice","id":"339ad02c-0a6d-4b83-b777-f7eaaf0e60e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"customer_id","value":"33855","type":"text","description":"int, options - set this if you want to change the customer on draft invoices only
\n"},{"key":"type","value":"1","type":"text"},{"key":"custom_job_title","value":"","type":"text"},{"key":"custom_number","value":"INV-01566","type":"text"},{"key":"work_order_custom_number","value":"","type":"text"},{"key":"purchase_order_number","value":"","type":"text"},{"key":"date_issued","value":"2024-05-20","type":"text"},{"key":"date_expire","value":"2024-05-27","type":"text"},{"key":"quantity_type","value":"","type":"text"},{"key":"adjustment_name","value":"","type":"text"},{"key":"adjustment_total","value":"","type":"text"},{"key":"adjustment_type","value":"1","type":"text"},{"key":"adjustment_percent","value":"","type":"text"},{"key":"message","value":"","type":"text"},{"key":"terms","value":"","type":"text"},{"key":"payment_methods[0]","value":"cc","type":"text"},{"key":"payment_methods[1]","value":"cash","type":"text"},{"key":"items[0][id]","value":"55773","type":"text","description":"int, required - If id = 0 a new item line will be inserted, else if id > 0 an existent item will be updated
\n"},{"key":"items[0][type]","value":"1","type":"text"},{"key":"items[0][name]","value":"Cleaning updated","type":"text"},{"key":"items[0][description]","value":"","type":"text"},{"key":"items[0][price]","value":"200","type":"text"},{"key":"items[0][qty]","value":"2","type":"text"},{"key":"items[0][tax_percent]","value":"","type":"text"},{"key":"items[0][tax_rate_id]","value":"","type":"text"},{"key":"items[0][discount_type]","value":"1","type":"text"},{"key":"items[0][discount_amount]","value":"","type":"text"},{"key":"items[0][discount_percent]","value":"","type":"text"}]},"url":"{{url}}/connect/api/v1/invoices/48595","description":"You can use a sparse object to update certain fields or full object.
\n","urlObject":{"path":["connect","api","v1","invoices","48595"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"339ad02c-0a6d-4b83-b777-f7eaaf0e60e7"},{"name":"Delete invoice","id":"eecdb11a-6c64-4884-a06e-ae0fcebe7e47","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/invoices/48595","urlObject":{"path":["connect","api","v1","invoices","48595"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"eecdb11a-6c64-4884-a06e-ae0fcebe7e47"},{"name":"Send invoice","id":"501a2452-a366-4774-a2ea-5163929e6573","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"{{url}}/connect/api/v1/invoices/5984/send","urlObject":{"path":["connect","api","v1","invoices","5984","send"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"501a2452-a366-4774-a2ea-5163929e6573"}],"id":"751ea3d7-3644-4b0f-a563-5041e71023dd","event":[{"listen":"prerequest","script":{"id":"bb15b026-2df6-4d09-8e3c-2c6fd1347779","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"dab3e258-849c-4ac4-ad02-3ee865d84532","type":"text/javascript","exec":[""]}}],"_postman_id":"751ea3d7-3644-4b0f-a563-5041e71023dd","description":""},{"name":"Invoice Attachments","item":[{"name":"List all attachments","id":"aecb6abf-711c-403b-a102-dd643ae1128d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/invoice/attachments?invoice_id=53179","description":"A list of invoice_attachment object. The API returns max 20 attachments for the requested invoice.
\n","urlObject":{"path":["connect","api","v1","invoice","attachments"],"host":["{{url}}"],"query":[{"key":"invoice_id","value":"53179"}],"variable":[]}},"response":[{"id":"e26fc934-9110-402b-afa0-398fc8334c00","name":"List all attachments","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":{"raw":"{{url}}/connect/api/v1/invoice/attachments?invoice_id=53179","host":["{{url}}"],"path":["connect","api","v1","invoice","attachments"],"query":[{"key":"invoice_id","value":"53179"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Thu, 07 May 2026 15:33:16 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/7.4.33"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"invoice_attachments\": [\n {\n \n \"id\": \"111\",\n \"invoice_id\": \"222\",\n \"name_original\": \"cabinet.jpg\",\n \"name_custom\": null,\n \"type\": \"image/jpeg\",\n \"extension\": \"jpg\",\n \"size\": \"30964\",\n \"encrypted\": \"0\",\n \"url\": \"https://...\",\n \"url_thumbnail\": \"https://...\", \n \"is_image\": true,\n \"datetime_added\": \"2026-05-07T15:27:22+00:00\",\n \"datetime_updated\": null\n }, \n ]\n}\n "}],"_postman_id":"aecb6abf-711c-403b-a102-dd643ae1128d"},{"name":"Upload attachment","id":"977766fe-50d0-4151-8448-d582d7267367","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":" multipart/form-data","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"File to be uploaded, using multipart/form-data protocol.
\n","type":"file","value":null}]},"url":"{{url}}/connect/api/v1/invoice/attachments/upload?invoice_id=53179","description":"To upload a file you need to send a request with header Content-Type: multipart/form-data. Include the file you want to upload in the request. File data is sent as sections in a multipart document in the body of the request.
\n","urlObject":{"path":["connect","api","v1","invoice","attachments","upload"],"host":["{{url}}"],"query":[{"key":"invoice_id","value":"53179"}],"variable":[]}},"response":[],"_postman_id":"977766fe-50d0-4151-8448-d582d7267367"},{"name":"Delete attachment","id":"0a7d51a7-8c79-43c4-b532-c30a720b9f13","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/invoice/attachments/673?invoice_id=53179","urlObject":{"path":["connect","api","v1","invoice","attachments","673"],"host":["{{url}}"],"query":[{"key":"invoice_id","value":"53179"}],"variable":[]}},"response":[],"_postman_id":"0a7d51a7-8c79-43c4-b532-c30a720b9f13"}],"id":"a7bbf202-8c60-4b99-89c3-41fb451d44f1","_postman_id":"a7bbf202-8c60-4b99-89c3-41fb451d44f1","description":""},{"name":"Invoice Payments","item":[{"name":"List all payments for an invoice","id":"293cb8f1-18db-4956-a2b3-9bddb5b2d6da","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/invoice/payments?invoice_id=200","description":"A list of Invoice object
Pagination
A list of Invoice object
Pagination
A list with tax rates
\n","urlObject":{"path":["connect","api","v1","tax_rates"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"e84ad1ea-d907-4cce-8e12-616cbb16759e"},{"name":"Get tax rate","id":"c9cb0d76-96a8-462e-bf79-bdccb49e38aa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/tax_rates/5","urlObject":{"path":["connect","api","v1","tax_rates","5"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"b57bc5eb-034f-41d8-a2a0-2009e65616a2","name":"Get tax rate","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/tax_rates/5"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 14 May 2025 19:45:20 GMT"},{"key":"Server","value":"Apache/2.4.38 (Debian)"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"Content-Length","value":"91"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"tax_rate\": {\n \"id\": \"5\",\n \"name\": \"Arizona\",\n \"rate\": 12.77,\n \"rate_text\": \"12.77%\",\n \"is_default\": \"0\"\n }\n}"}],"_postman_id":"c9cb0d76-96a8-462e-bf79-bdccb49e38aa"}],"id":"2e143990-9709-43a1-8e66-8caf73b8129f","_postman_id":"2e143990-9709-43a1-8e66-8caf73b8129f","description":""},{"name":"Work Orders","item":[{"name":"List work orders","id":"79f5a46e-7d13-41c2-b343-5468c8f6a78f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/work_orders?customer_id=&status=&custom_number=&name=&search=&search_type=&order=date_issued_desc&page=&rows_per_page=0","description":"A list of Work Order object
Pagination
int, optional - Filter by customer
\n","type":"text/plain"},"key":"customer_id","value":""},{"description":{"content":"int, optional - Filter by work order status, values: 1 = New, 2 = Scheduled, 3 = Completed, 4 = Closed, 5 = Withdrawn, 6 = Invoiced, 7 = Paused
\n","type":"text/plain"},"key":"status","value":""},{"description":{"content":"string, optional, search by custom number
\n","type":"text/plain"},"key":"custom_number","value":""},{"description":{"content":"string, optional search by job name
\n","type":"text/plain"},"key":"name","value":""},{"description":{"content":"string, optional - Search by multiple fields custom_number, name, description...
\n","type":"text/plain"},"key":"search","value":""},{"description":{"content":"string, optional - empty for exact match or fuzzy for fuzzy search
\n","type":"text/plain"},"key":"search_type","value":""},{"description":{"content":"string, optional - Sort by date-issued-asc, date-issued-desc, event-date-asc, event-date-desc, date-completed-asc, date-completed-desc, name-asc, name-desc, number-asc, number-desc, total-asc, total-desc, priority-asc, priority-desc
\n","type":"text/plain"},"key":"order","value":"date_issued_desc"},{"description":{"content":"int, optional - Default 1
\n","type":"text/plain"},"key":"page","value":""},{"description":{"content":"int, optional - Default 20
\n","type":"text/plain"},"key":"rows_per_page","value":"0"}],"variable":[]}},"response":[{"id":"d14709d8-2805-4642-ae50-216beadd17d9","name":"List work orders","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":{"raw":"{{url}}/connect/api/v1/work_orders?customer_id=&status=&search=&order=&page=&rows_per_page=","host":["{{url}}"],"path":["connect","api","v1","work_orders"],"query":[{"key":"customer_id","value":"","description":"int, optional - Filter by customer"},{"key":"status","value":"","description":"int, optional - Filter by work order status, values: 1 = New, 2 = Scheduled, 3 = Completed, 4 = Closed, 5 = Withdrawn, 6 = Invoiced, 7 = Paused"},{"key":"search","value":"","description":"string, optional - Search by multiple fields custom_number, name, description..."},{"key":"order","value":"","description":"string, optional - Sort by name-asc, name-desc, number-asc, number-desc, date-issued-asc, date-issued-desc, priority-asc, priority-desc"},{"key":"page","value":"","description":"int, optional - Default 1"},{"key":"rows_per_page","value":"","description":"int, optional - Default 20"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"work_orders\": [\n {\n\t \"id\": \"2458\",\n\t \"customer\": {\n\t \"id\": \"19321\",\n\t \"type_service\": \"1\",\n\t \"display_name\": \"John Doe\",\n\t \"first_name\": \"John\",\n\t \"last_name\": \"Doe\",\n\t \"email\": \"johndoe@test.com\",\n\t \"phone\": \"2123334444\"\n\t },\n\t \"work_order_type\": null,\n\t \"work_order_priority\": null,\n\t \"customer_address_id\": \"-1\",\n\t \"custom_number\": \"WO-361\",\n\t \"date_issued\": \"2021-03-28\",\n\t \"purchase_order_number\": \"PO-123456\",\n\t \"name\": \"Carpet Cleaning\",\n\t \"description\": \"Have to clean all carpets\",\n\t \"notes\": \"Please call the customer before starting the job\",\n\t \"location\": {\n\t \"address_full\": \"300 North Los Angeles Street, Suite 10, Los Angeles, CA, 90012\",\n\t \"latlng\": \"34.0539775,-118.240053\"\n\t },\n\t \"status\": \"2\",\n\t \"status_text\": \"Scheduled\",\n\t \"employees\": [\n\t {\n\t \"id\": \"108\",\n\t \"is_owner\": true,\n\t \"first_name\": \"Michael\",\n\t \"last_name\": \"Pogues\",\n\t \"phone\": \"2123456718\",\n\t \"email\": \"mikepogues@gmail.com\",\n\t \"about\": \"About for the business owner\",\n\t \"image_avatar\": {\n\t \"url_or\": \"https://markate.test/cdn/20201103/employee_108_b203d9f3b4_or.jpg\",\n\t \"url_sm\": \"https://markate.test/cdn/20201103/employee_108_b203d9f3b4_sm.jpg\"\n\t }\n\t }\n\t ],\n\t \"send_start_work\": null,\n\t \"send_end_work\": null,\n\t \"items\": [\n\t {\n\t \"id\": \"3917\",\n\t \"type\": \"1\",\n\t \"type_text\": \"Service\",\n\t \"name\": \"Service item\",\n\t \"description\": \"The description for service item\",\n\t \"qty\": 1,\n\t \"price\": 100,\n\t \"discount_type\": \"2\",\n\t \"discount_percent\": 25,\n\t \"discount_amount\": 25,\n\t \"tax_percent\": 0,\n\t \"tax_amount\": 0,\n\t \"tax_rate_id\": \"0\",\n\t \"total\": 75,\n\t \"position\": \"0\"\n\t },\n\t {\n\t \"id\": \"3918\",\n\t \"type\": \"2\",\n\t \"type_text\": \"Material\",\n\t \"name\": \"Material item\",\n\t \"description\": \"The description for material item\",\n\t \"qty\": 1,\n\t \"price\": 100,\n\t \"discount_type\": \"2\",\n\t \"discount_percent\": 25,\n\t \"discount_amount\": 25,\n\t \"tax_percent\": 0,\n\t \"tax_amount\": 0,\n\t \"tax_rate_id\": \"0\",\n\t \"total\": 75,\n\t \"position\": \"1\"\n\t }\n\t ],\n\t \"subtotal\": \"150.00\",\n\t \"adjustment_name\": \"Fee\",\n\t \"adjustment_total\": \"1.00\",\n\t \"deposit_amount\": \"0.00\",\n\t \"total\": \"151.00\",\n\t \"total_due\": 151,\n\t \"event\": {\n\t \"id\": \"1000\",\n\t \"name\": \"Carpet Cleaning\",\n\t \"datetime_start\": \"2021-03-14 10:00:00\",\n\t \"datetime_end\": \"2021-03-14 11:00:00\",\n\t \"timezone\": \"America/Phoenix\",\n\t \"timezone_text\": \"Arizona Time (UTC -7)\",\n\t \"datetime_start_iso\": \"2021-03-14T10:00:00-07:00\",\n\t \"datetime_end_iso\": \"2021-03-14T11:00:00-07:00\"\n\t },\n\t \"datetime_added\": \"2021-03-16T02:54:40+00:00\",\n\t \"datetime_updated\": \"2021-03-16T02:55:41+00:00\"\n }\n ],\n \"pagination\": {\n \"page\": 1,\n \"next\": 2,\n \"previous\": 0,\n \"rows_per_page\": 20,\n \"total_rows\": 674,\n \"total_pages\": 34\n }\n}"}],"_postman_id":"79f5a46e-7d13-41c2-b343-5468c8f6a78f"},{"name":"Get work order","id":"e06d34b2-f0aa-45df-ad02-2712ad81e073","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/work_orders/11082","urlObject":{"path":["connect","api","v1","work_orders","11082"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"dbc23baf-7d4f-4efa-b3e3-d1d9b7a73a72","name":"Get work order","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/work_orders/2458"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"work_order\": {\n \"id\": \"2458\",\n \"customer\": {\n \"id\": \"19321\",\n \"type_service\": \"1\",\n \"display_name\": \"John Doe\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"johndoe@test.com\",\n \"phone\": \"2123334444\"\n },\n \"work_order_type\": null,\n \"work_order_priority\": null,\n \"customer_address_id\": \"-1\",\n \"custom_number\": \"WO-361\",\n \"date_issued\": \"2021-03-28\",\n \"purchase_order_number\": \"PO-123456\",\n \"name\": \"Carpet Cleaning\",\n \"description\": \"Have to clean all carpets\",\n \"notes\": \"Please call the customer before starting the job\",\n \"location\": {\n \"address_full\": \"300 North Los Angeles Street, Suite 10, Los Angeles, CA, 90012\",\n \"latlng\": \"34.0539775,-118.240053\"\n },\n \"status\": \"2\",\n \"status_text\": \"Scheduled\",\n \"employees\": [\n {\n \"id\": \"108\",\n \"is_owner\": true,\n \"first_name\": \"Michael\",\n \"last_name\": \"Pogues\",\n \"phone\": \"2123456718\",\n \"email\": \"mikepogues@gmail.com\",\n \"about\": \"About for the business owner\",\n \"image_avatar\": {\n \"url_or\": \"https://markate.test/cdn/20201103/employee_108_b203d9f3b4_or.jpg\",\n \"url_sm\": \"https://markate.test/cdn/20201103/employee_108_b203d9f3b4_sm.jpg\"\n }\n }\n ],\n \"send_start_work\": null,\n \"send_end_work\": null,\n \"items\": [\n {\n \"id\": \"3917\",\n \"type\": \"1\",\n \"type_text\": \"Service\",\n \"name\": \"Service item\",\n \"description\": \"The description for service item\",\n \"qty\": 1,\n \"price\": 100,\n \"discount_type\": \"2\",\n \"discount_percent\": 25,\n \"discount_amount\": 25,\n \"tax_percent\": 0,\n \"tax_amount\": 0,\n \"tax_rate_id\": \"0\",\n \"total\": 75,\n \"position\": \"0\"\n },\n {\n \"id\": \"3918\",\n \"type\": \"2\",\n \"type_text\": \"Material\",\n \"name\": \"Material item\",\n \"description\": \"The description for material item\",\n \"qty\": 1,\n \"price\": 100,\n \"discount_type\": \"2\",\n \"discount_percent\": 25,\n \"discount_amount\": 25,\n \"tax_percent\": 0,\n \"tax_amount\": 0,\n \"tax_rate_id\": \"0\",\n \"total\": 75,\n \"position\": \"1\"\n }\n ],\n \"subtotal\": \"150.00\",\n \"adjustment_name\": \"Fee\",\n \"adjustment_total\": \"1.00\",\n \"deposit_amount\": \"0.00\",\n \"total\": \"151.00\",\n \"total_due\": 151,\n \"event\": {\n \"id\": \"1000\",\n \"name\": \"Carpet Cleaning\",\n \"datetime_start\": \"2021-03-14 10:00:00\",\n \"datetime_end\": \"2021-03-14 11:00:00\",\n \"timezone\": \"America/Phoenix\",\n \"timezone_text\": \"Arizona Time (UTC -7)\",\n \"datetime_start_iso\": \"2021-03-14T10:00:00-07:00\",\n \"datetime_end_iso\": \"2021-03-14T11:00:00-07:00\"\n },\n \"datetime_added\": \"2021-03-16T02:54:40+00:00\",\n \"datetime_updated\": \"2021-03-16T02:55:41+00:00\"\n }\n}"}],"_postman_id":"e06d34b2-f0aa-45df-ad02-2712ad81e073"},{"name":"Get work orders config","id":"5e8f4335-df26-4da9-bb80-af187ce18086","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/work_orders/config","urlObject":{"path":["connect","api","v1","work_orders","config"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"608b17e2-43df-4fed-afe7-d00f35ebef52","name":"Get invoices config","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/invoices/config"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 30 May 2024 12:10:52 GMT"},{"key":"Server","value":"Apache/2.4.38 (Debian)"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"},{"key":"Content-Length","value":"1737"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"invoice_empty\": {\n \"type\": 4,\n \"custom_job_title\": \"\",\n \"custom_number\": \"INV-446962\",\n \"work_order_custom_number\": \"\",\n \"purchase_order_number\": \"\",\n \"date_expire\": \"2024-06-06\",\n \"date_expire_text\": \"06-Jun-2024\",\n \"date_expire_commercial\": \"2024-07-29\",\n \"date_expire_commercial_text\": \"29-Jul-2024\",\n \"date_issued\": \"2024-05-30\",\n \"date_issued_text\": \"30-May-2024\",\n \"date_issued_text_passed\": \"Today\",\n \"subtotal\": 0,\n \"adjustment_name\": \"\",\n \"adjustment_total\": 0,\n \"adjustment_type\": 1,\n \"adjustment_percent\": 0,\n \"total\": 0,\n \"message\": \"R - message\",\n \"terms\": \"R - terms\",\n \"status\": \"K\",\n \"status_text\": \"Draft\",\n \"payment_methods_data\": [\n {\n \"id\": \"cc\",\n \"name\": \"Credit Card\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"check\",\n \"name\": \"Check\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"cash\",\n \"name\": \"Cash\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"ach\",\n \"name\": \"ACH Bank Transfer\",\n \"active\": true,\n \"selected\": true\n },\n {\n \"id\": \"credit\",\n \"name\": \"Credit Note/E-Gift Card\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"deposit\",\n \"name\": \"Direct Deposit\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"paypal\",\n \"name\": \"PayPal\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"venmo\",\n \"name\": \"Venmo\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"zelle\",\n \"name\": \"Zelle\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"cash-app\",\n \"name\": \"Cash App\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"financing\",\n \"name\": \"Consumer Financing\",\n \"active\": true,\n \"selected\": false\n },\n {\n \"id\": \"other\",\n \"name\": \"Other\",\n \"active\": true,\n \"selected\": false\n }\n ]\n },\n \"invoice_type\": {\n \"1\": \"Deposit\",\n \"2\": \"Partial Payment\",\n \"3\": \"Final Payment\",\n \"4\": \"Total Due\"\n },\n \"item_type\": {\n \"1\": \"Service\",\n \"2\": \"Material\",\n \"3\": \"Product\"\n },\n \"quantity_types\": {\n \"0\": \"Qty\",\n \"1\": \"Hours\",\n \"2\": \"Sq ft\",\n \"3\": \"Rooms\",\n \"4\": \"Lin ft\"\n },\n \"tax_rate\": {\n \"id\": \"81\",\n \"name\": \"Standard Tax\",\n \"rate\": 10,\n \"rate_text\": \"10%\",\n \"is_default\": \"1\"\n },\n \"payment_cc_active\": [\n \"Square\",\n \"Wisetack\"\n ]\n}"}],"_postman_id":"5e8f4335-df26-4da9-bb80-af187ce18086"},{"name":"Create work order","id":"503107eb-e7e1-40a5-b8a3-4548243154b9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"customer_id","value":"3160","type":"text","description":"int, required - A customer id
\n"},{"key":"customer_address_id","value":"432","type":"text","description":"int, required - If -1 will set the WO location as customer location, else if > 0 a valid customer_address_id is required
\n"},{"key":"date_issued","value":"2025-10-08","type":"text","description":"string, required - Work Order date issued, format yyyy-mm-dd
\n"},{"key":"name","value":"Carpet Cleaning","type":"text","description":"string, required - Job name
\n"},{"key":"description","value":"Have to clean all carpets","type":"text","description":"string, optional - Job description
\n"},{"key":"purchase_order_number","value":"PO-123456","type":"text","description":"string, optional - Purchase order
\n"},{"key":"work_order_type_id","value":"0","type":"text","description":"int, optional - Job type
\n"},{"key":"work_order_priority_id","value":"0","type":"text","description":"int, optional - Job priority
\n"},{"key":"notes","value":"Please call the customer before starting the job","type":"text","description":"string, optional - Some remarks or notes for employees
\n"},{"key":"items[0][id]","value":"0","type":"text","description":"int, required - Value id = 0 a new item line will be inserted, kept for consistentcy with update
\n"},{"key":"items[0][type]","value":"1","type":"text","description":"int, required - Values 1 = service, 2 = material, 3 = product
\n"},{"key":"items[0][name]","value":"Service item","type":"text","description":"string, required
\n"},{"key":"items[0][description]","value":"The description for service item","type":"text","description":"string, required - Value can be empy string
\n"},{"key":"items[0][qty]","value":"1","type":"text","description":"float, required
\n"},{"key":"items[0][price]","value":"100","type":"text","description":"float, required
\n"},{"key":"items[0][tax_percent]","value":"10","type":"text","description":"float, required - Empty if e empty, if set has to be between 0 -100
\n"},{"key":"items[0][tax_rate_id]","value":"1","type":"text","description":"int, required - Valued can be empty if no tax is set, else a valid tax rate id is needed
\n"},{"key":"items[0][discount_type]","value":"2","type":"text","description":"int, required - Values: empty = not set, 1 = percent, 2 = amount
\n"},{"key":"items[0][discount_amount]","value":"25","type":"text","description":"float, optional
\n"},{"key":"items[0][discount_percent]","value":"0","type":"text","description":"float, optional
\n"},{"key":"items[1][id]","value":"0","type":"text"},{"key":"items[1][type]","value":"2","type":"text"},{"key":"items[1][name]","value":"Material item","type":"text"},{"key":"items[1][description]","value":"The description for material item","type":"text"},{"key":"items[1][qty]","value":"1","type":"text"},{"key":"items[1][price]","value":"100","type":"text"},{"key":"items[1][tax_percent]","value":"10","type":"text"},{"key":"items[1][tax_rate_id]","value":"1","type":"text"},{"key":"items[1][discount_type]","value":"2","type":"text"},{"key":"items[1][discount_amount]","value":"25","type":"text"},{"key":"items[1][discount_percent]","value":"0","type":"text"},{"key":"adjustment_name","value":"Fee","type":"text","description":"string, optional - The name for adjustment
\n"},{"key":"adjustment_total","value":"1","type":"text","description":"float, optional - The adjustment amount
\n"}]},"url":"{{url}}/connect/api/v1/work_orders","urlObject":{"path":["connect","api","v1","work_orders"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"503107eb-e7e1-40a5-b8a3-4548243154b9"},{"name":"Update work order","id":"fa1e0231-5407-4185-b05f-569926e002b0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"customer_id","value":"14429","type":"text","description":"int, optional - send only if work order status = 1 = new (can change customer only if work order status is new)
\n","disabled":true},{"key":"customer_address_id","value":"332","type":"text","description":"int, optional - set if you want to change the job location
\n","disabled":true},{"key":"date_issued","value":"2024-06-29","type":"text","disabled":true},{"key":"custom_number","value":"WO-333","type":"text","disabled":true},{"key":"name","value":"Carpet Cleaning","type":"text","disabled":true},{"key":"description","value":"Description of the job","type":"text","disabled":true},{"key":"purchase_order_number","value":"ABC 333","type":"text","disabled":true},{"key":"work_order_type_id","value":"1","type":"text","disabled":true},{"key":"work_order_priority_id","value":"6","type":"text","description":"int, required - If id = 0 a new item line will be inserted, else if id > 0 an existent item will be updated
\n","disabled":true},{"key":"notes","value":"Some internal notes for employees","type":"text","disabled":true},{"key":"items[0][id]","value":"12998","type":"text"},{"key":"items[0][type]","value":"1","type":"text"},{"key":"items[0][name]","value":"Service item updated","type":"text"},{"key":"items[0][description]","value":"The description for service item","type":"text"},{"key":"items[0][qty]","value":"1","type":"text"},{"key":"items[0][price]","value":"100","type":"text"},{"key":"items[0][tax_percent]","value":"1.2346","type":"text"},{"key":"items[0][tax_rate_id]","value":"22","type":"text"},{"key":"items[0][discount_type]","value":"2","type":"text"},{"key":"items[0][discount_amount]","value":"25","type":"text"},{"key":"items[0][discount_percent]","value":"0","type":"text"},{"key":"items[1][id]","value":"12999","type":"text"},{"key":"items[1][type]","value":"2","type":"text"},{"key":"items[1][name]","value":"Material item","type":"text"},{"key":"items[1][description]","value":"The description for material item","type":"text"},{"key":"items[1][qty]","value":"1","type":"text"},{"key":"items[1][price]","value":"100","type":"text"},{"key":"items[1][tax_percent]","value":"","type":"text"},{"key":"items[1][tax_rate_id]","value":"","type":"text"},{"key":"items[1][discount_type]","value":"2","type":"text"},{"key":"items[1][discount_amount]","value":"25","type":"text"},{"key":"items[1][discount_percent]","value":"0","type":"text"},{"key":"adjustment_name","value":"","type":"text","disabled":true},{"key":"adjustment_total","value":"","type":"text","disabled":true}]},"url":"{{url}}/connect/api/v1/work_orders/11191","description":"You can use a sparse object to update certain fields or full object.
\n","urlObject":{"path":["connect","api","v1","work_orders","11191"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"fa1e0231-5407-4185-b05f-569926e002b0"},{"name":"Change status","id":"33156323-94f7-452c-97e1-7dca939f3d86","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"status","value":"2","type":"text","description":"int, required - Allowed values 1 = New, 2 = Scheduled, 3 = Completed, 4 = Closed, 5 = Withdrawn, 6 = Invoiced, 7 = Paused
\n"},{"key":"message","value":"I completed the job","type":"text","description":"string, optional - A message to log
\n"}]},"url":"{{url}}/connect/api/v1/work_orders/11086/update_status","urlObject":{"path":["connect","api","v1","work_orders","11086","update_status"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"af210d9d-f8a8-4145-ba7f-f56ed56a7f64","name":"Change status","originalRequest":{"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"status","value":"2","type":"text","description":"int, required - Allowed values 1 = New, 2 = Scheduled, 3 = Completed, 4 = Closed, 5 = Withdrawn, 6 = Invoiced, 7 = Paused"},{"key":"message","value":"I completed the job","type":"text","description":"string, optional - A message to log"}]},"url":"{{url}}/connect/api/v1/work_orders/2444/update_status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"2444\",\n \"status\": 2,\n \"update_status\": true\n}"}],"_postman_id":"33156323-94f7-452c-97e1-7dca939f3d86"}],"id":"8a272553-aec9-4bef-aeaa-ebddbedbd8b4","event":[{"listen":"prerequest","script":{"id":"bb15b026-2df6-4d09-8e3c-2c6fd1347779","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"dab3e258-849c-4ac4-ad02-3ee865d84532","type":"text/javascript","exec":[""]}}],"_postman_id":"8a272553-aec9-4bef-aeaa-ebddbedbd8b4","description":""},{"name":"Work Order Attachments","item":[{"name":"List all attachments","id":"cdc7ae4e-0177-4d0b-9989-46a9e6a95e19","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/work_order/attachments?work_order_id=13630","description":"A list of work_order_attachment object. The API returns max 20 attachments for the requested work order.
\n","urlObject":{"path":["connect","api","v1","work_order","attachments"],"host":["{{url}}"],"query":[{"key":"work_order_id","value":"13630"}],"variable":[]}},"response":[{"id":"442b70ac-a083-421a-b9c7-4e14f4c468b6","name":"List all attachments","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":{"raw":"{{url}}/connect/api/v1/work_order/attachments?work_order_id=13630","host":["{{url}}"],"path":["connect","api","v1","work_order","attachments"],"query":[{"key":"work_order_id","value":"13630"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Thu, 07 May 2026 15:31:35 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/7.4.33"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"POST, GET, OPTIONS, DELETE, PUT"},{"key":"Access-Control-Max-Age","value":"600"},{"key":"Access-Control-Allow-Headers","value":"api-token, x-api-token, api-version, x-api-key, x-app-version, x-requested-with, Content-Type, origin, authorization, accept, client-security-token"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"work_order_attachments\": [\n {\n \"id\": \"111\",\n \"work_order_id\": \"222\",\n \"name_original\": \"cabinet.jpg\",\n \"name_custom\": null,\n \"type\": \"image/jpeg\",\n \"extension\": \"jpg\",\n \"size\": \"30964\",\n \"encrypted\": \"0\",\n \"url\": \"https://...\",\n \"url_thumbnail\": \"https://...\", \n \"is_image\": true,\n \"datetime_added\": \"2026-05-07T15:27:22+00:00\",\n \"datetime_updated\": null\n }, \n ]\n}"}],"_postman_id":"cdc7ae4e-0177-4d0b-9989-46a9e6a95e19"},{"name":"Upload attachment","id":"a3e14406-b0f3-40f9-97ca-c95dec34c5a3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"},{"key":"Content-Type","value":" multipart/form-data","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"File to be uploaded, using multipart/form-data protocol.
\n","type":"file","value":null}]},"url":"{{url}}/connect/api/v1/work_order/attachments/upload?work_order_id=1","description":"To upload a file you need to send a request with header Content-Type: multipart/form-data. Include the file you want to upload in the request. File data is sent as sections in a multipart document in the body of the request.
\n","urlObject":{"path":["connect","api","v1","work_order","attachments","upload"],"host":["{{url}}"],"query":[{"key":"work_order_id","value":"1"}],"variable":[]}},"response":[],"_postman_id":"a3e14406-b0f3-40f9-97ca-c95dec34c5a3"},{"name":"Delete attachment","id":"93bf4cd3-9369-485f-b251-02fb801c1144","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Markate-Version","value":"{{markate_version}}","type":"text"}],"url":"{{url}}/connect/api/v1/work_order/attachments/2?work_order_id=1","urlObject":{"path":["connect","api","v1","work_order","attachments","2"],"host":["{{url}}"],"query":[{"key":"work_order_id","value":"1"}],"variable":[]}},"response":[],"_postman_id":"93bf4cd3-9369-485f-b251-02fb801c1144"}],"id":"008ecdc7-76a9-4344-bc94-cf8e1a8ec2c9","_postman_id":"008ecdc7-76a9-4344-bc94-cf8e1a8ec2c9","description":""},{"name":"Webhooks","item":[],"id":"a0c8603c-933d-4153-b69d-c88060aaaf58","description":"Get notified about events at the time they occur.
\nA POST request is made to your webhook_uri with secret params as your webhook_secret.
\nThe body of the POST request is a JSON string and the header Content-Type application/json.
\n{\n \"id\":\"009612f7-b4a1-4355-927b-a5d939bfa7db\",\n \"markate_user_id\":\"bmpwd8Y75PgBGZ\",\n \"type\":\"customer.updated\",\n \"created_at\":\"2021-03-11T13:51:35+00:00\",\n \"api_version\":\"20210301\",\n \"secret\":\"whs_fc502696bb56c85b8d9c47bdbdace22057896be52a3\",\n \"data\":{\n \"customer\":{\n \"id\":\"19305\",\n \"display_name\":\"John Doe\",\n \"first_name\":\"John\",\n \"last_name\":\"Doe\",\n \"company\":\"Acme Inc\",\n ...\n }\n }\n}\n\ncustomer.added
customer.updated
Triggered on add or update customer
customer_address.added
customer_address.updated
Triggered on add or update a customer address
event.added
event.updated
On add or update an event
expense.added
expense.updated
On add or update an expense
invoice.added
invoice.updated
On add or update an invoice
lead.added
lead.updated
On add or update a lead or opportunity
work_order.added
work_order.updated
On add or update work order
work_order.updated_status
When work order status changes
client.connected
Check if the client is still connected
The API has a combined limit of 120 requests per minute per user. The error message \"Too many requests\" with HTTP status code 429 is returned.
\n","event":[{"listen":"prerequest","script":{"id":"05337169-fd52-426a-9dad-5077b712e62b","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"9d33e3cb-3bba-437c-b21b-3ecebc8cfec2","type":"text/javascript","exec":[""]}}],"_postman_id":"ff346bae-de62-4088-a42b-2902cb37ebf6"},{"name":"Old v20210301","item":[{"name":"Events","item":[{"name":"List events ical v20210301","id":"57721be8-c385-4664-8343-238fe4c15e74","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/events/ical?date_start=2023-05-01&date_end=2023-05-31&work_order_id=&employee_id=","description":"Will return maximum 400 events and the interval between date_start and date_end can not be over 93 days (~ 3 months)
\nA list of Event object
\n","urlObject":{"path":["connect","api","v1","events","ical"],"host":["{{url}}"],"query":[{"description":{"content":"required, string - Format yyyy-mm-dd get all events starting from this date
\n","type":"text/plain"},"key":"date_start","value":"2023-05-01"},{"description":{"content":"required, string - Format yyyy-mm-dd get all events up to this date
\n","type":"text/plain"},"key":"date_end","value":"2023-05-31"},{"description":{"content":"optional, int - Filter by work order
\n","type":"text/plain"},"key":"work_order_id","value":""},{"description":{"content":"optional, int - Filter by employee
\n","type":"text/plain"},"key":"employee_id","value":""}],"variable":[]}},"response":[{"id":"1065be30-347a-4c24-b83e-c84c50f452f5","name":"List events","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":{"raw":"{{url}}/connect/api/v1/events?date_start=2021-01-01&date_end=2021-04-01","host":["{{url}}"],"path":["connect","api","v1","events"],"query":[{"key":"date_start","value":"2021-01-01","description":"required, string - Format yyyy-mm-dd get all events starting from this date"},{"key":"date_end","value":"2021-04-01","description":"required, string - Format yyyy-mm-dd get all events up to this date"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"events\": [\n {\n\t \"id\": \"999\",\n\t \"type\": \"1\",\n\t \"is_type_blocked\": false,\n\t \"is_type_customer\": true,\n\t \"is_type_lead\": false,\n\t \"is_type_work_order\": false,\n\t \"work_order_id\": \"0\",\n\t \"customer\": {\n\t \"id\": \"19321\",\n\t \"display_name\": \"John Doe\",\n\t \"first_name\": \"John\",\n\t \"last_name\": \"Doe\",\n\t \"email\": \"johndoe@test.com\",\n\t \"phone\": \"2123334444\"\n\t },\n\t \"location\": {\n\t \"address\": \"300 North Los Angeles Street\",\n\t \"address_secondary\": \"Suite 10\",\n\t \"city\": \"Los Angeles\",\n\t \"state\": \"CA\",\n\t \"zip\": \"90012\"\n\t },\n\t \"name\": \"Carpet Cleaning\",\n\t \"datetime_start\": \"2021-03-12 10:00:00\",\n\t \"datetime_start_iso\": \"2021-03-12T10:00:00-05:00\",\n\t \"datetime_end\": \"2021-03-12 11:00:00\",\n\t \"datetime_end_iso\": \"2021-03-12T11:00:00-05:00\",\n\t \"timezone\": \"America/New_York\",\n\t \"timezone_text\": \"Eastern Time (UTC -4)\",\n\t \"color\": {\n\t \"id\": 1,\n\t \"code\": \"#4cb052\"\n\t },\n\t \"all_day\": false,\n\t \"notify_at\": \"PT2H\",\n\t \"notify_at_text\": \"2 hours before\",\n\t \"notes\": \"Has 2 dogs\",\n\t \"is_recurring\": false,\n\t \"datetime_added\": \"2021-03-16T02:48:36+00:00\",\n\t \"datetime_updated\": null\n },\n ]\n}"}],"_postman_id":"57721be8-c385-4664-8343-238fe4c15e74"},{"name":"List events v20210301","id":"a26f37f2-dcc4-4c7c-9ada-6a8647b89059","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"20210301"}],"url":"{{url}}/connect/api/v1/events?date_start=2023-05-01&date_end=2023-05-31&work_order_id=&employee_id=","description":"Will return maximum 400 events and the interval between date_start and date_end can not be over 93 days (~ 3 months)
\nA list of Event object
\n","urlObject":{"path":["connect","api","v1","events"],"host":["{{url}}"],"query":[{"description":{"content":"required, string - Format yyyy-mm-dd get all events starting from this date
\n","type":"text/plain"},"key":"date_start","value":"2023-05-01"},{"description":{"content":"required, string - Format yyyy-mm-dd get all events up to this date
\n","type":"text/plain"},"key":"date_end","value":"2023-05-31"},{"description":{"content":"optional, int - Filter by work order
\n","type":"text/plain"},"key":"work_order_id","value":""},{"description":{"content":"optional, int - Filter by employee
\n","type":"text/plain"},"key":"employee_id","value":""}],"variable":[]}},"response":[{"id":"22a9a2b6-36b4-4e92-958e-9c55131c1038","name":"List events","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":{"raw":"{{url}}/connect/api/v1/events?date_start=2021-01-01&date_end=2021-04-01","host":["{{url}}"],"path":["connect","api","v1","events"],"query":[{"key":"date_start","value":"2021-01-01","description":"required, string - Format yyyy-mm-dd get all events starting from this date"},{"key":"date_end","value":"2021-04-01","description":"required, string - Format yyyy-mm-dd get all events up to this date"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"events\": [\n {\n\t \"id\": \"999\",\n\t \"type\": \"1\",\n\t \"is_type_blocked\": false,\n\t \"is_type_customer\": true,\n\t \"is_type_lead\": false,\n\t \"is_type_work_order\": false,\n\t \"work_order_id\": \"0\",\n\t \"customer\": {\n\t \"id\": \"19321\",\n\t \"display_name\": \"John Doe\",\n\t \"first_name\": \"John\",\n\t \"last_name\": \"Doe\",\n\t \"email\": \"johndoe@test.com\",\n\t \"phone\": \"2123334444\"\n\t },\n\t \"location\": {\n\t \"address\": \"300 North Los Angeles Street\",\n\t \"address_secondary\": \"Suite 10\",\n\t \"city\": \"Los Angeles\",\n\t \"state\": \"CA\",\n\t \"zip\": \"90012\"\n\t },\n\t \"name\": \"Carpet Cleaning\",\n\t \"datetime_start\": \"2021-03-12 10:00:00\",\n\t \"datetime_start_iso\": \"2021-03-12T10:00:00-05:00\",\n\t \"datetime_end\": \"2021-03-12 11:00:00\",\n\t \"datetime_end_iso\": \"2021-03-12T11:00:00-05:00\",\n\t \"timezone\": \"America/New_York\",\n\t \"timezone_text\": \"Eastern Time (UTC -4)\",\n\t \"color\": {\n\t \"id\": 1,\n\t \"code\": \"#4cb052\"\n\t },\n\t \"all_day\": false,\n\t \"notify_at\": \"PT2H\",\n\t \"notify_at_text\": \"2 hours before\",\n\t \"notes\": \"Has 2 dogs\",\n\t \"is_recurring\": false,\n\t \"datetime_added\": \"2021-03-16T02:48:36+00:00\",\n\t \"datetime_updated\": null\n },\n ]\n}"}],"_postman_id":"a26f37f2-dcc4-4c7c-9ada-6a8647b89059"},{"name":"Get event v20210301","id":"590e5135-a2df-4b0d-a643-04ad029506b3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"20210301"}],"url":"{{url}}/connect/api/v1/events/2273","urlObject":{"path":["connect","api","v1","events","2273"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"f7571bbc-fc2b-422e-a4d6-8d7474203f44","name":"Get event","originalRequest":{"method":"GET","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"}],"url":"{{url}}/connect/api/v1/events/958"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"event\": {\n \"id\": \"958\",\n \"type\": \"1\",\n \"is_type_blocked\": false,\n \"is_type_customer\": true,\n \"is_type_lead\": false,\n \"is_type_work_order\": false,\n \"work_order_id\": \"0\",\n \"customer\": {\n \"id\": \"3142\",\n \"display_name\": \"Aisha Voss\",\n \"first_name\": \"Aisha\",\n \"last_name\": \"Voss\",\n \"email\": \"aisha@gmail.com\",\n \"phone\": \"6232995971\"\n },\n \"location\": {\n \"address\": \"55 Fruit Street\",\n \"address_secondary\": \"\",\n \"city\": \"Boston\",\n \"state\": \"MA\",\n \"zip\": \"02114\"\n },\n \"name\": \"F\",\n \"datetime_start\": \"2021-01-08 21:00:00\",\n \"datetime_start_iso\": \"2021-01-08T21:00:00-05:00\",\n \"datetime_end\": \"2021-01-08 22:00:00\",\n \"datetime_end_iso\": \"2021-01-08T22:00:00-05:00\",\n \"timezone\": \"America/New_York\",\n \"timezone_text\": \"Eastern Time (UTC -4)\",\n \"color\": {\n \"id\": 1,\n \"code\": \"#4cb052\"\n },\n \"all_day\": false,\n \"notify_at\": \"PT5M\",\n \"notify_at_text\": \"5 minutes before\",\n \"notes\": \"\",\n \"is_recurring\": false,\n \"datetime_added\": \"2021-01-09T02:34:45+00:00\",\n \"datetime_updated\": null\n }\n}"}],"_postman_id":"590e5135-a2df-4b0d-a643-04ad029506b3"},{"name":"Create event v20210301","id":"fe86ece4-6141-4851-ba6b-2792cf5d3df4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"20210301"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"1","type":"text","description":"int, required - Allowed values 1 for normal event, 2 for work order event
\n"},{"key":"customer_id","value":"33855","type":"text","description":"int, required - The customer id
\n"},{"key":"employee_id","value":"560","type":"text","description":"int, optional - Assign the event to an employee, in this case only one employee per event is allowed
\n"},{"key":"name","value":"Carpet Cleaning","type":"text","description":"string, required - Event name
\n"},{"key":"datetime_start","value":"2023-05-09 10:00:00","type":"text","description":"string, required - Event start date and time as input by user
\n"},{"key":"datetime_end","value":"2023-05-09 11:00:00","type":"text","description":"string, required - Event end date and time as input by user
\n"},{"key":"all_day","value":"0","type":"text","description":"int, required - Default 0, If set to 1 the datetime_start and datetime_end time will be ignored
\n"},{"key":"timezone","value":"America/Phoenix","type":"text","description":"optional - If not set will use the default timezone, see /events/config endpoint timezone_default
\n","disabled":true},{"key":"color_id","value":"1","type":"text","description":"int, required - A color id, default 1
\n"},{"key":"notify_at","value":"PT2H","type":"text","description":"string, optional - A date-time interval, If not set it will default to user settings
\n","disabled":true},{"key":"notes","value":"Has 2 dogs","type":"text","description":"string, optional - some notes
\n"}]},"url":"{{url}}/connect/api/v1/events","urlObject":{"path":["connect","api","v1","events"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"4698af7b-a26c-47b2-a73e-e46f6ae46726","name":"Create event","originalRequest":{"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"type","value":"1","type":"text","description":"int, required - Allowed values 1 for normal event, 2 for work order event"},{"key":"customer_id","value":"19321","type":"text","description":"int, required - The customer id"},{"key":"name","value":"Carpet Cleaning","type":"text","description":"string, required - Event name"},{"key":"datetime_start","value":"2021-03-12 10:00:00","type":"text","description":"string, required - Event start date and time as input by user"},{"key":"datetime_end","value":"2021-03-12 11:00:00","type":"text","description":"string, required - Event end date and time as input by user"},{"key":"all_day","value":"0","type":"text","description":"int, required - Default 0, If set to 1 the datetime_start and datetime_end time will be ignored"},{"key":"timezone","value":"America/Phoenix","type":"text","description":"optional - If not set will use the default timezone, see /events/config endpoint timezone_default","disabled":true},{"key":"color_id","value":"1","type":"text","description":"int, required - A color id, default 1"},{"key":"notify_at","value":"PT2H","type":"text","description":"string, required - A date-time interval"},{"key":"notes","value":"Has 2 dogs","type":"text","description":"string, optional - some notes"}]},"url":"{{url}}/connect/api/v1/events"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"event\": {\n \"id\": \"999\",\n \"type\": \"1\",\n \"is_type_blocked\": false,\n \"is_type_customer\": true,\n \"is_type_lead\": false,\n \"is_type_work_order\": false,\n \"work_order_id\": \"0\",\n \"customer\": {\n \"id\": \"19321\",\n \"display_name\": \"John Doe\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"johndoe@test.com\",\n \"phone\": \"2123334444\"\n },\n \"location\": {\n \"address\": \"300 North Los Angeles Street\",\n \"address_secondary\": \"Suite 10\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90012\"\n },\n \"name\": \"Carpet Cleaning\",\n \"datetime_start\": \"2021-03-12 10:00:00\",\n \"datetime_start_iso\": \"2021-03-12T10:00:00-05:00\",\n \"datetime_end\": \"2021-03-12 11:00:00\",\n \"datetime_end_iso\": \"2021-03-12T11:00:00-05:00\",\n \"timezone\": \"America/New_York\",\n \"timezone_text\": \"Eastern Time (UTC -4)\",\n \"color\": {\n \"id\": 1,\n \"code\": \"#4cb052\"\n },\n \"all_day\": false,\n \"notify_at\": \"PT2H\",\n \"notify_at_text\": \"2 hours before\",\n \"notes\": \"Has 2 dogs\",\n \"is_recurring\": false,\n \"datetime_added\": \"2021-03-16T02:48:36+00:00\",\n \"datetime_updated\": null\n }\n}"}],"_postman_id":"fe86ece4-6141-4851-ba6b-2792cf5d3df4"},{"name":"Update event v20210301","id":"5b0afd51-30b1-4184-8ba7-9b28530446e0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Markate-Version","type":"text","value":"{{markate_version}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"name","value":"Carpet Cleaning updated","type":"text"},{"key":"datetime_start","value":"2021-09-12 13:20:00","type":"text","disabled":true},{"key":"datetime_end","value":"2021-09-14 14:05:00","type":"text","disabled":true},{"key":"timezone","value":"America/Chicago","type":"text","disabled":true},{"key":"employee_id","value":"394","type":"text","description":"Optional, int - Change the employee assigned to event or work order
\n"},{"key":"all_day","value":"0","type":"text","disabled":true},{"key":"color_id","value":"1","type":"text","disabled":true},{"key":"notify_at","value":"PT2H","type":"text","disabled":true},{"key":"notes","value":"Has 2 dogs and a cat","type":"text","disabled":true}]},"url":"{{url}}/connect/api/v1/events/2281","description":"You can use a sparse object to update certain fields or full object.
\n","urlObject":{"path":["connect","api","v1","events","2281"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"5b0afd51-30b1-4184-8ba7-9b28530446e0"}],"id":"97cfe178-2e9b-457a-b8fe-a9d1f4ce5eee","_postman_id":"97cfe178-2e9b-457a-b8fe-a9d1f4ce5eee","description":""}],"id":"e06372b9-8876-47cb-bb3a-a0266a2af9f6","_postman_id":"e06372b9-8876-47cb-bb3a-a0266a2af9f6","description":""}],"event":[{"listen":"prerequest","script":{"id":"7a4fa952-655d-464a-a1c8-5d02c40f1ab5","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"0ac63b48-1ede-43e4-9d10-058ea360ff15","type":"text/javascript","exec":[""]}}]}