{"id":9787,"date":"2024-10-01T08:09:35","date_gmt":"2024-10-01T08:09:35","guid":{"rendered":"https:\/\/simple-simon.com\/integration\/make-your-own-integration\/"},"modified":"2026-06-26T07:43:46","modified_gmt":"2026-06-26T07:43:46","slug":"make-your-own-integration","status":"publish","type":"integration","link":"https:\/\/simple-simon.com\/en\/integrations\/make-your-own-integration\/","title":{"rendered":"Make your own integration"},"content":{"rendered":"\n\n\n<section class=\"theme-section theme-hero__wrapper theme-p-sm text__light \">\n\t<div class=\"theme-wrapper theme-element bl bg__dark-blue \">\n\t\t\t\t\t<div class=\"theme-hero__img-partial\">\n\t\t\t\t\t\t\t\t\t<img decoding=\"async\" src=\"https:\/\/simple-simon.com\/wp-content\/uploads\/2025\/07\/vecteezy_young-male-plumber-in-an-orange-overall-holding-a-wrench-and_56814923-scaled.png\" alt=\"\">\n\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<div class=\"container\">\n\t\t\t<div class=\"row justify-content-between\">\n\t\t\t\t<div class=\"col-xl-6\">\n\t\t\t\t\t<div class=\"theme-hero__content\">\n\t\t\t\t\t\t<h1>Get Started with the Simple-Simon API Integration<\/h1>\n<p>Protect your data and optimise your workflows with the Simple-Simon API. Follow these best practices for a secure and efficient implementation.<\/p>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t<\/div>\n\n\t\t<\/div>\n\n\n\t<\/div>\n<\/section>\n\n\n\t<section class=\"theme-section theme-split theme-content-variable active text-left theme-p-sm\">\n\t\t<div class=\"theme-content-variable__row theme-content-variable__card theme-wrapper\">\n\t\t\t<div class=\"container-fluid\">\n\t\t\t\t<div class=\"row justify-content-md-between \">\n\t\t\t\t\t<div class=\"col-md-5 p-0 order-md-2 order-1\">\n\t\t\t\t\t\t<div class=\"theme-content-variable__card-img img-scale\">\n\t\t\t\t\t\t\t<img decoding=\"async\" src=\"https:\/\/simple-simon.com\/wp-content\/uploads\/2024\/12\/vecteezy_two-colleagues-collaborate-in-a-modern-office-setting_65951627-scaled.jpg\" alt=\"\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t<div class=\"col-md-6 order-md-1 order-2\">\n\t\t\t\t\t\t<div class=\"theme-content-variable__row-content theme-content-variable__card-content text-left \">\n\t\t\t\t\t\t\t<h2>Key Restrictions for Using the Simple-Simon API:<\/h2>\n<ul>\n<li>Active licence required: The username and password used must be linked to an active licence for the current month. This does not have to be an additional user account.<\/li>\n<li>API access request: Submit a one-time request to Simon Support to activate API access. You\u2019ll receive an email containing a URL and full documentation for each available method.<\/li>\n<li>Your responsibility: You are solely responsible for protecting your API credentials from unauthorised access and for maintaining the integrity and quality of your data.<\/li>\n<li>Costs: The first three months of API usage are free. After that, the service costs [ss_api_price] per year.<\/li>\n<\/ul>\n\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t<\/div>\n\t\t<\/div>\n\t<\/section>\n\n\n\t<section class=\"theme-section theme-split theme-content-variable active text-right theme-p-sm\">\n\t\t<div class=\"theme-content-variable__row theme-content-variable__card theme-wrapper\">\n\t\t\t<div class=\"container-fluid\">\n\t\t\t\t<div class=\"row justify-content-md-between \">\n\t\t\t\t\t<div class=\"col-md-5 p-0 \">\n\t\t\t\t\t\t<div class=\"theme-content-variable__card-img img-scale\">\n\t\t\t\t\t\t\t<img decoding=\"async\" src=\"https:\/\/simple-simon.com\/wp-content\/uploads\/2025\/07\/vecteezy_engineers-inspect-and-assess-the-residential-home_67260273-scaled.jpg\" alt=\"\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t<div class=\"col-md-6 \">\n\t\t\t\t\t\t<div class=\"theme-content-variable__row-content theme-content-variable__card-content text-right \">\n\t\t\t\t\t\t\t<h2>Create your own integration<\/h2>\n<p>To build your own custom integration with Simple-Simon, you\u2019ll need the following:<br \/>\n<strong>1.<\/strong> Simon Licence Code: A 16-digit Simon licence key.<br \/>\n<strong>2.<\/strong> Simon Office Username: For example, the email address used in your request.<br \/>\n<strong>3.<\/strong> Password: The password associated with this user account.<br \/>\n<strong>4.<\/strong> One-Time Request: API access must be requested once to activate the integration.<br \/>\n<strong>5.<\/strong> Api Key: Received via the email upon the One-Time Request.<\/p>\n<p><strong>Support Details<\/strong>:<br \/>\nSimple-Simon\u2019s API server supports HTTP GET\/POST\/PUT\/DELETE methods and ODATA protocols, SOAP is not supported. The API is available in English only, and all entity names are also in English.<\/p>\n\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t<\/div>\n\t\t<\/div>\n\t<\/section>\n\n\n\t<section class=\"theme-section theme-split theme-content-variable active text-left theme-p-sm\">\n\t\t<div class=\"theme-content-variable__row theme-content-variable__card theme-wrapper\">\n\t\t\t<div class=\"container-fluid\">\n\t\t\t\t<div class=\"row justify-content-md-between align-items-center\">\n\t\t\t\t\t<div class=\"col-md-5 p-0 order-md-2 order-1\">\n\t\t\t\t\t\t<div class=\"theme-content-variable__card-img img-no-scale\">\n\t\t\t\t\t\t\t<img decoding=\"async\" src=\"https:\/\/simple-simon.com\/wp-content\/uploads\/2024\/10\/Own-Integration-Icon-1.png\" alt=\"\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t<div class=\"col-md-6 order-md-1 order-2\">\n\t\t\t\t\t\t<div class=\"theme-content-variable__row-content theme-content-variable__card-content text-left \">\n\t\t\t\t\t\t\t<h2>Key Entities in the Simple-Simon API<\/h2>\n<ul>\n<li><strong>Customer<\/strong>: Represents a customer. A customer can have one or more associated work locations.<\/li>\n<li><strong>Contact<\/strong>: A contact person linked to a customer or location.<\/li>\n<li><strong>Location<\/strong>: The job or work address linked to a work order. A location can also exist without being linked to a customer.<\/li>\n<li><strong>WorkOrder<\/strong>: The actual job sheet. Every work order is always linked to a location.<\/li>\n<li><strong>Equipment<\/strong>: Assets or installations registered at a location, linked to job sheets.<\/li>\n<li><strong>ItemGroup<\/strong>: A group of items or materials, used for organising inventory.<\/li>\n<li><strong>Item<\/strong>: Individual articles or materials within an item group.<\/li>\n<li><strong>User<\/strong>: Represents both office staff and field workers.<\/li>\n<li><strong>Planning<\/strong>: Always contains a link between a job sheet and a user (for scheduling).<\/li>\n<li><strong>WorkOrderSurvey<\/strong>: Digital forms or checklists created in Simon, linked to a specific job sheet.<\/li>\n<li><strong>UsedItem<\/strong>: Materials used or consumed on a job sheet.<\/li>\n<li><strong>TimeSheet<\/strong>: Travel and working hours associated with a job sheet.<\/li>\n<li><strong>Attachment<\/strong>: Files or photos attached to a job sheet, location, or customer.<\/li>\n<\/ul>\n\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t<\/div>\n\t\t<\/div>\n\t<\/section>\n\n\n\t<section class=\"theme-section theme-split theme-content-variable active text-right theme-p-sm\">\n\t\t<div class=\"theme-content-variable__row theme-content-variable__card theme-wrapper\">\n\t\t\t<div class=\"container-fluid\">\n\t\t\t\t<div class=\"row justify-content-md-between align-items-center\">\n\t\t\t\t\t<div class=\"col-md-5 p-0 \">\n\t\t\t\t\t\t<div class=\"theme-content-variable__card-img img-no-scale\">\n\t\t\t\t\t\t\t<img decoding=\"async\" src=\"https:\/\/simple-simon.com\/wp-content\/uploads\/2025\/07\/Laura-website-pictures-39.png\" alt=\"\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t<div class=\"col-md-6 \">\n\t\t\t\t\t\t<div class=\"theme-content-variable__row-content theme-content-variable__card-content text-right \">\n\t\t\t\t\t\t\t<h2>General<\/h2>\n<p>To authenticate with the Simple-Simon API, you must first obtain an access token by calling the login endpoint with the following credentials:<\/p>\n<ul>\n<li><strong>lickey<\/strong>: Your 16-digit Simple-Simon licence code<\/li>\n<li><strong>apiKey<\/strong>: Received via Email,<\/li>\n<li><strong>password<\/strong>: Your user password,<\/li>\n<li><strong>username<\/strong>: Your Simon username (e.g. the email address linked to your account)<\/li>\n<\/ul>\n<p>Upon successful authentication, you will receive a bearer token that must be included as a header parameter in all subsequent API requests. This token has an expiration time, once expired request a new one again by calling the login endpoint again to avoid interruptions during your session. For full details on the login endpoint, request\/response format, and all available operations, refer to the interactive API documentation received via Email.<\/p>\n\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t<\/div>\n\t\t<\/div>\n\t<\/section>\n\n\n\t<section class=\"theme-section theme-split theme-content-variable active text-left theme-p-sm\">\n\t\t<div class=\"theme-content-variable__row theme-content-variable__card theme-wrapper\">\n\t\t\t<div class=\"container-fluid\">\n\t\t\t\t<div class=\"row justify-content-md-between align-items-center\">\n\t\t\t\t\t<div class=\"col-md-5 p-0 order-md-2 order-1\">\n\t\t\t\t\t\t<div class=\"theme-content-variable__card-img img-no-scale\">\n\t\t\t\t\t\t\t<img decoding=\"async\" src=\"https:\/\/simple-simon.com\/wp-content\/uploads\/2024\/12\/vecteezy_professional-discussion-between-colleagues-in-a-modern_59232530-scaled.jpg\" alt=\"\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t<div class=\"col-md-6 order-md-1 order-2\">\n\t\t\t\t\t\t<div class=\"theme-content-variable__row-content theme-content-variable__card-content text-left \">\n\t\t\t\t\t\t\t<h2>Methodology Simons<\/h2>\n<p>The Simple Simon API follows a consistent and uniform structure across all entities. The following example using the location table (representing a job site or work address) applies similarly to other available entities.<br \/>\nYou can perform the ODATA operations on work addresses:<\/p>\n<ul>\n<li>POST: \/locations : for inserting new location<\/li>\n<li>PUT: \/locations\/{id} : for updating a particular location with Id<\/li>\n<li>DELETE: \/locations\/{id} : for deleting a particular location with Id<\/li>\n<li>GET: \/locations\/{id} : for fetching a particular location with Id<\/li>\n<li>GET: \/locations: for fetching list of locations.<\/li>\n<\/ul>\n<p>You can supply filter parameters to narrow down the results, ODATA filtering can be applied to all the properties available. To gain more knowledge on how ODATA filtering works, click <a href=\"https:\/\/www.odata.org\/getting-started\/basic-tutorial\/#filter\">here<\/a>.<\/p>\n<p>For update and delete operations, you are required to provide the <em>Id<\/em>. Refer to the API documentation for supported filters.<\/p>\n\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t<\/div>\n\t\t<\/div>\n\t<\/section>\n\n\n\t<section class=\"theme-section theme-split theme-content-variable active text-right theme-p-sm\">\n\t\t<div class=\"theme-content-variable__row theme-content-variable__card theme-wrapper\">\n\t\t\t<div class=\"container-fluid\">\n\t\t\t\t<div class=\"row justify-content-md-between \">\n\t\t\t\t\t<div class=\"col-md-5 p-0 \">\n\t\t\t\t\t\t<div class=\"theme-content-variable__card-img img-scale\">\n\t\t\t\t\t\t\t<img decoding=\"async\" src=\"https:\/\/simple-simon.com\/wp-content\/uploads\/2024\/09\/vecteezy_making-handshake-two-construction-workers-in-uniform-and_15302866-scaled.jpg\" alt=\"\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t<div class=\"col-md-6 \">\n\t\t\t\t\t\t<div class=\"theme-content-variable__row-content theme-content-variable__card-content text-right \">\n\t\t\t\t\t\t\t<h2>Terms of Use for the Simple-Simon API<\/h2>\n<p>When using the Simple-Simon API, the following terms and conditions apply:<\/p>\n<ul>\n<li>Access Request: To gain access, send a message to <a href=\"https:\/\/simple-simon.com\/en\/support\/\">support<\/a> requesting API activation. We will ensure your environment is configured appropriately for API usage.<\/li>\n<li>Active Licence Required: You must have at least one active (paid) Simple-Simon licence to use the API. Unfortunately, API access is not available during the trial period.<\/li>\n<li>At Your Own Risk: Any disruptions caused to your Simple-Simon environment, ERP integration, or calendar setup through API usage are entirely at your own risk.<\/li>\n<li>Support Costs: Should you require assistance from our IT team, support is charged at \u20ac1,200 per man-day, with a minimum charge of one full man-day.<\/li>\n<\/ul>\n<p><strong>Optimise your workflow with the Simple-Simon API<\/strong><br \/>\nSeamlessly integrate Simple-Simon with your existing business systems and improve efficiency across the board!<\/p>\n\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t<\/div>\n\t\t<\/div>\n\t<\/section>","protected":false},"excerpt":{"rendered":"","protected":false},"featured_media":10833,"parent":0,"template":"","class_list":["post-9787","integration","type-integration","status-publish","has-post-thumbnail","hentry","integration_category-australia","integration_category-belgie-en","integration_category-canada","integration_category-denmark","integration_category-duitsland-en","integration_category-finland","integration_category-france","integration_category-ireland","integration_category-nederland-en","integration_category-new-zeeland","integration_category-norway","integration_category-oostenrijk-en","integration_category-south-africa","integration_category-sweden","integration_category-united-kingdom","integration_category-united-states","integration_category-zwitserland-en"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/simple-simon.com\/en\/wp-json\/wp\/v2\/integration\/9787","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/simple-simon.com\/en\/wp-json\/wp\/v2\/integration"}],"about":[{"href":"https:\/\/simple-simon.com\/en\/wp-json\/wp\/v2\/types\/integration"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/simple-simon.com\/en\/wp-json\/wp\/v2\/media\/10833"}],"wp:attachment":[{"href":"https:\/\/simple-simon.com\/en\/wp-json\/wp\/v2\/media?parent=9787"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}