{"id":49394,"date":"2024-10-11T14:19:54","date_gmt":"2024-10-11T12:19:54","guid":{"rendered":"https:\/\/moovago.com\/api-getting-started\/"},"modified":"2026-01-08T16:16:54","modified_gmt":"2026-01-08T15:16:54","slug":"api-getting-started","status":"publish","type":"page","link":"https:\/\/moovago.com\/en\/api-getting-started\/","title":{"rendered":"API: Getting started"},"content":{"rendered":"\t\t<div data-elementor-type=\"wp-page\" data-elementor-id=\"49394\" class=\"elementor elementor-49394 elementor-30215\" data-elementor-post-type=\"page\">\n\t\t\t\t<div class=\"elementor-element elementor-element-f6de3a2 e-flex e-con-boxed e-con e-parent\" data-id=\"f6de3a2\" data-element_type=\"container\" data-e-type=\"container\" data-settings=\"{&quot;background_background&quot;:&quot;gradient&quot;,&quot;shape_divider_bottom&quot;:&quot;waves&quot;}\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t\t\t<div class=\"elementor-shape elementor-shape-bottom\" aria-hidden=\"true\" data-negative=\"false\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" viewBox=\"0 0 1000 100\" preserveAspectRatio=\"none\">\n\t<path class=\"elementor-shape-fill\" d=\"M421.9,6.5c22.6-2.5,51.5,0.4,75.5,5.3c23.6,4.9,70.9,23.5,100.5,35.7c75.8,32.2,133.7,44.5,192.6,49.7\n\tc23.6,2.1,48.7,3.5,103.4-2.5c54.7-6,106.2-25.6,106.2-25.6V0H0v30.3c0,0,72,32.6,158.4,30.5c39.2-0.7,92.8-6.7,134-22.4\n\tc21.2-8.1,52.2-18.2,79.7-24.2C399.3,7.9,411.6,7.5,421.9,6.5z\"\/>\n<\/svg>\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-335523e e-con-full e-flex e-con e-child\" data-id=\"335523e\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t<div class=\"elementor-element elementor-element-a27d40c elementor-widget elementor-widget-heading\" data-id=\"a27d40c\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h1 class=\"elementor-heading-title elementor-size-default\">Getting started with the API<\/h1>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-8c4c063 e-con-full e-flex e-con e-child\" data-id=\"8c4c063\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t<div class=\"elementor-element elementor-element-4b44b4c elementor-widget__width-auto elementor-widget elementor-widget-button\" data-id=\"4b44b4c\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"button.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<div class=\"elementor-button-wrapper\">\n\t\t\t\t\t<a class=\"elementor-button elementor-button-link elementor-size-sm\" href=\"https:\/\/api-trial.moovago.app\/doc\" rel=\"nofollow noopener\" target=\"_blank\">\n\t\t\t\t\t\t<span class=\"elementor-button-content-wrapper\">\n\t\t\t\t\t\t<span class=\"elementor-button-icon\">\n\t\t\t\t<svg aria-hidden=\"true\" class=\"e-font-icon-svg e-fas-arrow-right\" viewBox=\"0 0 448 512\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\"><path d=\"M190.5 66.9l22.2-22.2c9.4-9.4 24.6-9.4 33.9 0L441 239c9.4 9.4 9.4 24.6 0 33.9L246.6 467.3c-9.4 9.4-24.6 9.4-33.9 0l-22.2-22.2c-9.5-9.5-9.3-25 .4-34.3L311.4 296H24c-13.3 0-24-10.7-24-24v-32c0-13.3 10.7-24 24-24h287.4L190.9 101.2c-9.8-9.3-10-24.8-.4-34.3z\"><\/path><\/svg>\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t<span class=\"elementor-button-text\">API documentation<\/span>\n\t\t\t\t\t<\/span>\n\t\t\t\t\t<\/a>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-26fd81d e-flex e-con-boxed e-con e-parent\" data-id=\"26fd81d\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t\t\t<div class=\"elementor-element elementor-element-00e8c69 elementor-widget elementor-widget-text-editor\" data-id=\"00e8c69\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>Welcome to the Moovago API Getting Started Guide!<\/p><p>The Moovago API allows you to create\/read\/modify\/delete your various data stored in Moovago, in a programmatic way (= data exchange with your ERP, your servers&#8230;).<\/p><p>This guide shows you how to configure and use our API.<\/p><p>The elements currently offered by the API are those requested by our customers. If you have any other requirements or questions\/comments, please let us know at support@moovago.com. <\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-f065862 e-flex e-con-boxed e-con e-parent\" data-id=\"f065862\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t\t\t<div class=\"elementor-element elementor-element-09146c8 elementor-widget elementor-widget-heading\" data-id=\"09146c8\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h2 class=\"elementor-heading-title elementor-size-default\">Terminology<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-9e659fd elementor-widget elementor-widget-text-editor\" data-id=\"9e659fd\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>It&#8217;s useful to understand the names of a few elements of the Moovago application.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-f9ca4ab elementor-widget elementor-widget-text-editor\" data-id=\"f9ca4ab\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<ul><li><span style=\"color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">Company<\/span>: &#8220;Company&#8221; which can be a customer, a prospect or a suspect.<br>It can contain one or more contact persons (<span style=\"color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; letter-spacing: 0.32px;\"><span style=\"font-weight: bold; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">CompanyContact<\/span><span style=\"color: #212121; font-family: Roboto; font-size: 18px; letter-spacing: normal;\">).<\/span><\/span><br>Depending on the type of team involved, there may be other <strong data-renderer-mark=\"true\">labels <\/strong>called<strong data-renderer-mark=\"true\"> Mandator<\/strong><span style=\"color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">.<\/span> A company may therefore have 0 to several <strong data-renderer-mark=\"true\">Mandator<\/strong> tags. <\/li><li><span style=\"color: #1d1f21; font-family: Consolas, Monaco, Courier New, monospace;\"><span style=\"font-size: 14px; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\"><b>CompanyContact:<\/b><\/span><\/span> &#8220;Contact person&#8221;, physical person within a C<span style=\"color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">ompany<\/span> with whom you are in contact.<\/li><\/ul><ul><li><span style=\"color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">Mandator<\/span>: &#8220;Principal&#8221;, organization (supplier or brand) which entrusts a mission of representation or sale of its products or services.<br>It can be attached to several companies <span style=\"color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">(Company<\/span>).<\/li><li><span style=\"color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">Segmentation<\/span>: A segmentation is used to classify <span style=\"color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">companies<\/span> according to criteria defined by the team (e.g. categories, activities, etc.). There is one segmentation (and therefore a list of several criteria) per team. A criterion is the equivalent of a single-choice question.<br>Generally, a <span style=\"color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">company<\/span> belongs to only one team, and is therefore characterized by a single segmentation. However, in some configurations (if the company also has <span style=\"caret-color: #1d1f21; color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">Team<\/span>-type principals), the company may be characterized by several segmentation types.   <\/li><li><span style=\"color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">Team<\/span>: &#8220;Team&#8221;, a group of one or more users who use the application and belong to the same entity.<\/li><li><span style=\"color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">Turnover<\/span>: &#8220;Sales revenue&#8221;, invoice won, lost or order booked on a given date.<\/li><li><span style=\"color: #1d1f21; font-family: Consolas, Monaco, Courier New, monospace;\"><span style=\"font-size: 14px; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\"><b>ID:<\/b><\/span><\/span> An identifier<span style=\"background-color: transparent; font-size: 16px; color: #1d1f21; font-family: barlow, -apple-system, 'system-ui', sans-serif; letter-spacing: 0.32px; text-align: var(--text-align);\"><span style=\"color: #212121; font-family: Roboto; font-size: 18px; letter-spacing: normal;\"> that references the various elements in our system.<\/span><\/span><\/li><\/ul>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-f93473b e-flex e-con-boxed e-con e-parent\" data-id=\"f93473b\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t\t\t<div class=\"elementor-element elementor-element-0b54360 elementor-widget elementor-widget-heading\" data-id=\"0b54360\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h2 class=\"elementor-heading-title elementor-size-default\">Authentication<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-fa7ec41 elementor-widget elementor-widget-text-editor\" data-id=\"fa7ec41\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>Our API endpoints require API key authentication. <\/p><p>If you do not yet have a Moovago API key, please contact us at <a href=\"mailto:support@moovago.com\">support@moovago.com.<\/a><\/p><p>To authenticate yourself, simply add your API key to your request header.<br><em>(Refer to the instructions provided in the e-mail you received with your API key)<\/em><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-e47a47f e-flex e-con-boxed e-con e-parent\" data-id=\"e47a47f\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t\t\t<div class=\"elementor-element elementor-element-7fc10ce elementor-widget elementor-widget-heading\" data-id=\"7fc10ce\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h2 class=\"elementor-heading-title elementor-size-default\">GraphQL<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-4604445 elementor-widget elementor-widget-text-editor\" data-id=\"4604445\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>The Moovago API works with GraphQL.<br><br style=\"color: #222222; font-family: -apple-system, 'system-ui', system-ui, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px;\">Here&#8217;s what a GraphQL <strong>QUERY<\/strong> might look like:<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-5bfecf4 elementor-widget elementor-widget-code-highlight\" data-id=\"5bfecf4\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"prismjs-okaidia copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-javascript \">\n\t\t\t\t<code readonly=\"true\" class=\"language-javascript\">\n\t\t\t\t\t<xmp>{ \"query\": \"{ team { id name members { id alias } } }\" }<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-026479b elementor-widget elementor-widget-text-editor\" data-id=\"026479b\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>or (you can also specify a custom query name if you prefer):<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-e1f2605 elementor-widget elementor-widget-code-highlight\" data-id=\"e1f2605\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"prismjs-okaidia copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-javascript \">\n\t\t\t\t<code readonly=\"true\" class=\"language-javascript\">\n\t\t\t\t\t<xmp>{ \"query\": \"query MyTeamQuery { team { id name members { id alias } } }\" }<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-4b820fa elementor-widget elementor-widget-text-editor\" data-id=\"4b820fa\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>Sometimes you can provide input parameters (= variables) to filter the results (here, a <code style=\"font-size: 0.875em; font-family: Consolas, Monaco, 'Andale Mono', 'Ubuntu Mono', monospace; color: #222222;\">teamId<\/code> for example):<br style=\"color: #222222; font-family: -apple-system, 'system-ui', system-ui, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px;\"><em>Be careful, you must escape the quotation marks in the variable values.!<\/em><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-e84ced1 elementor-widget elementor-widget-code-highlight\" data-id=\"e84ced1\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"prismjs-okaidia copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-javascript \">\n\t\t\t\t<code readonly=\"true\" class=\"language-javascript\">\n\t\t\t\t\t<xmp>{ \"query\": \"{ companyList(filter: { teamId: \\\"XYZ\\\" }) { id name ownerIds } }\" }\n<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-00ccf44 elementor-widget elementor-widget-text-editor\" data-id=\"00ccf44\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>or (you can also use the <code style=\"font-size: 0.875em; font-family: Consolas, Monaco, 'Andale Mono', 'Ubuntu Mono', monospace; color: #222222;\">variables<\/code> field in a named query if you prefer):<br style=\"color: #222222; font-family: -apple-system, 'system-ui', system-ui, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px;\">This does not require escaping quotation marks =&gt; <strong>&#8220;<\/strong>must be written<strong> \\ &#8220;<\/strong><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-ed7f6eb elementor-widget elementor-widget-code-highlight\" data-id=\"ed7f6eb\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"prismjs-okaidia copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-javascript \">\n\t\t\t\t<code readonly=\"true\" class=\"language-javascript\">\n\t\t\t\t\t<xmp>{ \"query\": \"query MyCompanyListQuery($filter: FilterManyCompanyInput!) { companyList(filter: $filter) { id name ownerIds } }\", \"variables\": { \"filter\": { \"teamId\": \"XYZ\" } } }\n<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-c7b19d1 e-flex e-con-boxed e-con e-parent\" data-id=\"c7b19d1\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t\t\t<div class=\"elementor-element elementor-element-07bd4cc elementor-widget elementor-widget-text-editor\" data-id=\"07bd4cc\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>This is what a GraphQL <b>MUTATION query might look like :<\/b><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-7e5598a elementor-widget elementor-widget-code-highlight\" data-id=\"7e5598a\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"prismjs-okaidia copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-javascript \">\n\t\t\t\t<code readonly=\"true\" class=\"language-javascript\">\n\t\t\t\t\t<xmp>{ \"query\": \"mutation { company { create( input: { ownerIds: [\\\"XYZ\\\"], name: \\\"Moovago\\\", city: \\\"Niort\\\", address: \\\"46 Rue du 14 Juillet\\\", postalCode: \\\"79000\\\", phone: \\\"07 68 45 46 74\\\", email: \\\"support@moovago.com\\\", note: \\\"L application du commercial\\\" } ) { recordId } } }\" }\n<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-715f152 elementor-widget elementor-widget-text-editor\" data-id=\"715f152\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>or (you can also use the <code style=\"font-family: Consolas, Monaco, 'Andale Mono', 'Ubuntu Mono', monospace; font-size: 0.875em; color: #222222;\">variables<\/code> field in a named query if you prefer):<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-1d7d5fe elementor-widget elementor-widget-code-highlight\" data-id=\"1d7d5fe\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"prismjs-okaidia copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-javascript \">\n\t\t\t\t<code readonly=\"true\" class=\"language-javascript\">\n\t\t\t\t\t<xmp>{ \"query\": \"mutation MyCompanyCreate($input: CompanyCreateInput!) { company { create(input: $input) { recordId } } }\", \"variables\": { \"input\": { \"ownerIds\": [\"XYZ\"], \"name\": \"Moovago\", \"city\": \"Niort\", \"address\": \"46 Rue du 14 Juillet\", \"postalCode\": \"79000\", \"phone\": \"07 68 45 46 74\", \"email\": \"support@moovago.com\", \"note\": \"L application du commercial\" } } }\n<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-4f49343 elementor-widget elementor-widget-text-editor\" data-id=\"4f49343\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>Before continuing, you may wish to consult the <a href=\"https:\/\/graphql.org\/\" target=\"_blank\" rel=\"noopener\">graphql.org<\/a> documentation to learn more.<\/p><p>We recommend you use a GraphQL client to help you write, send and test your GraphQL queries, such as: <a href=\"https:\/\/altairgraphql.dev\/\" target=\"_blank\" rel=\"noopener\">Altair GraphQL Client<\/a><\/p><p>Introspection is disabled on our server. So you can&#8217;t retrieve the GraphQL schema directly from our server.<br>However, you can download the Moovago API GraphQL schema file here: <a href=\"https:\/\/api2.moovago.app\/doc\/moovago_api_graphql_schema.gql\" download=\"\" target=\"_blank\" rel=\"noopener\">moovago_api_graphql_schema.gql<\/a> <\/p><p>and import it into the Altair client (In Altair&#8217;s top-right window, click on: Docs -&gt;&#8230; -&gt; Load Schema&#8230;)<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-5e60b6b elementor-widget elementor-widget-text-editor\" data-id=\"5e60b6b\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>Below are some examples of <strong>QUERY<\/strong> and <strong>MUTATION<\/strong> queries using the curl command line tool (replace &lt;your-api-key&gt; with the value of your API key).<\/p><p>You must also add the following header to your requests:<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-de12853 elementor-widget elementor-widget-code-highlight\" data-id=\"de12853\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"prismjs-okaidia copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-http \">\n\t\t\t\t<code readonly=\"true\" class=\"language-http\">\n\t\t\t\t\t<xmp>Content-Type: application\/json<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-98bd4bc elementor-widget elementor-widget-text-editor\" data-id=\"98bd4bc\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p style=\"margin: 0px 0px 20px; color: #222222; font-family: -apple-system, 'system-ui', system-ui, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px;\"> <\/p><p><strong>QUERY : <\/strong><\/p><p>Retrieve your team and team members:<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-d7025ad elementor-widget elementor-widget-code-highlight\" data-id=\"d7025ad\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"prismjs-okaidia copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-bash \">\n\t\t\t\t<code readonly=\"true\" class=\"language-bash\">\n\t\t\t\t\t<xmp>curl https:\/\/<api-backend>\/graphql \\\n  -X POST \\\n  -H '<your-api-key>' \\\n  -H 'Content-Type: application\/json' \\\n  -d '{ \"query\": \"query MyTeamQuery { team { id name members { id alias } } }\" }'<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-db9b612 elementor-widget elementor-widget-text-editor\" data-id=\"db9b612\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>Retrieve the list of your principals (replace &#8216;&lt;your-teamId&gt;&#8217;):<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-6f878e2 elementor-widget elementor-widget-code-highlight\" data-id=\"6f878e2\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"prismjs-okaidia copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-bash \">\n\t\t\t\t<code readonly=\"true\" class=\"language-bash\">\n\t\t\t\t\t<xmp>curl https:\/\/<api-backend>\/graphql \\\n  -X POST \\\n  -H '<your-api-key>' \\\n  -H 'Content-Type: application\/json' \\\n  -d '{ \"query\": \"query MyMandatorList($filter: FilterManyMandatorInput!) { mandatorList(filter: $filter) { id name }  }\", \"variables\": { \"filter\": { \"teamId\": \"<your-teamId>\" } } }'<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-7daebfb elementor-widget elementor-widget-text-editor\" data-id=\"7daebfb\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p style=\"margin: 0px 0px 20px; color: #222222; font-family: -apple-system, 'system-ui', system-ui, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px;\"><span style=\"font-weight: bold; text-align: var(--text-align);\"> <\/span><\/p><p><strong>MUTATION :<\/strong><\/p><p>Creation of a new company (replace &#8216;&lt;ownerId-value&gt;&#8217;):<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-8a63fea elementor-widget elementor-widget-code-highlight\" data-id=\"8a63fea\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"prismjs-okaidia copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-bash \">\n\t\t\t\t<code readonly=\"true\" class=\"language-bash\">\n\t\t\t\t\t<xmp>curl https:\/\/<api-backend>\/graphql \\\n  -X POST \\\n  -H '<your-api-key>' \\\n  -H 'Content-Type: application\/json' \\\n  -d '{ \"query\": \"mutation MyCompanyCreate($input: CompanyCreateInput!) { company { create(input: $input) { recordId } } }\", \"variables\": { \"input\": { \"ownerIds\": [\"<ownerId-value>\"], \"name\": \"Moovago\", \"city\": \"Niort\", \"address\": \"46 Rue du 14 Juillet\", \"postalCode\": \"79000\", \"phone\": \"07 68 45 46 74\", \"email\": \"support@moovago.com\", \"note\": \"L application du commercial\" } } }'<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-13362bd elementor-widget elementor-widget-text-editor\" data-id=\"13362bd\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<pre style=\"overflow: auto; margin-top: 0px; margin-bottom: 20px; color: #ffffff; box-sizing: border-box; font-size: 16px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;\"> <\/pre><p>Modifying an existing company (replace &#8216;&lt;companyId-value&gt;&#8217;):<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-b88e31a elementor-widget elementor-widget-code-highlight\" data-id=\"b88e31a\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"prismjs-okaidia copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-bash \">\n\t\t\t\t<code readonly=\"true\" class=\"language-bash\">\n\t\t\t\t\t<xmp>curl https:\/\/<api-backend>\/graphql \\\n-X POST \\\n-H '<your-api-key>' \\\n-H 'Content-Type: application\/json' \\\n-d '{ \"query\": \"mutation MyCompanyUpdate($input: CompanyUpdateInput!) { company { update(input: $input) { recordId } } }\", \"variables\": { \"input\": { \"id\": \"<companyId-value>\", \"input\": { \"note\": \"Here is my new note\"} } } }'<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-d62dd85 elementor-widget elementor-widget-spacer\" data-id=\"d62dd85\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-15300a4 e-flex e-con-boxed e-con e-parent\" data-id=\"15300a4\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t\t\t<div class=\"elementor-element elementor-element-daf03f0 elementor-widget elementor-widget-heading\" data-id=\"daf03f0\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h2 class=\"elementor-heading-title elementor-size-default\">GraphQL API reference<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-f6aa350 elementor-widget elementor-widget-text-editor\" data-id=\"f6aa350\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>See our <a href=\"https:\/\/api-trial.moovago.app\/doc\" target=\"_blank\" rel=\"noopener\" data-wplink-edit=\"true\">GraphQL API reference<\/a> documentation for a list of all possible queries, as well as all the details of our API.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-e158672 e-flex e-con-boxed e-con e-parent\" data-id=\"e158672\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t\t\t<div class=\"elementor-element elementor-element-2b0ec28 elementor-widget elementor-widget-heading\" data-id=\"2b0ec28\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h2 class=\"elementor-heading-title elementor-size-default\">Errors<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-6b3ec11 elementor-widget elementor-widget-text-editor\" data-id=\"6b3ec11\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>GraphQL APIs can return both correct data and errors in parallel. <span style=\"color: var( --e-global-color-text ); text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\">This is why the Moovago API will return HTTP <\/span><span style=\"text-align: var(--text-align); color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">200<\/span> <span style=\"color: var( --e-global-color-text ); text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\">codes <\/span><span style=\"color: var( --e-global-color-text ); text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\"> even if there are errors. <\/span> <\/p><p>By default, errors are contained in an <span style=\"color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">errors<\/span> table. You&#8217;ll find a description of each error in the &#8220;message&#8221; field. <br>It&#8217;s up to you to detect and handle these errors. For example, by intercepting all responses from our API and checking the <span style=\"background-color: rgba(226, 238, 240, 0.6); color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; text-align: var(--text-align);\">errors array .<\/span> <\/p><p><span style=\"color: var( --e-global-color-text ); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size ); text-align: var(--text-align);\">Here&#8217;s what a GraphQL response containing an error might look like:<\/span><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-c8390fd elementor-widget elementor-widget-code-highlight\" data-id=\"c8390fd\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"prismjs-okaidia copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-javascript \">\n\t\t\t\t<code readonly=\"true\" class=\"language-javascript\">\n\t\t\t\t\t<xmp>{\n  \"data\": null,\n  \"errors\": [\n    {\n      \"message\": \"You are not authorized to access this data\",\n      \"locations\": [],\n      \"errorType\": \"DataFetchingException\",\n      \"path\": [\n        \"companyList\"\n      ],\n      \"extensions\": null\n    }\n  ]\n}<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-708d670 elementor-widget elementor-widget-text-editor\" data-id=\"708d670\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><strong>Errors returned by mutations<\/strong><\/p><p>By default, errors returned by mutations are as described in the previous section.<\/p><p>But mutations can also return user and business logic errors, directly in the &#8220;data&#8221; sub-data. This allows you to separate these mutation-specific errors from the global-level errors seen earlier (used then only for analysis errors and other more general server-side errors). <\/p><p>All these mutation-specific errors are named with the suffix &#8220;Problem&#8221; (equivalent to an error code). Each mutation can return one or more errors. And each mutation describes the types of error it can return. You can then use it on the client side to <span style=\"text-align: var(--text-align);\"><span style=\"font-family: var( --e-global-typography-text-font-family );\">easily identify errors. Some error types can <\/span>also<span style=\"font-family: var( --e-global-typography-text-font-family );\"> be accompanied by<\/span><\/span><span style=\"font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size ); text-align: var(--text-align);\"> additional error metadata.<\/span>   <\/p><p><span style=\"font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size ); text-align: var(--text-align);\"> <strong>Example<\/strong><\/span><\/p><p>To retrieve errors specific to mutations, use the &#8220;message&#8221; field to retrieve textual error messages and the &#8220;__typename&#8221; field containing the error code (type: <i>Problem<\/i>).<\/p><p>We will therefore add the following code to the queries to retrieve the values of these 2 fields (for each of the errors returned):<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-b4c009d elementor-widget elementor-widget-code-highlight\" data-id=\"b4c009d\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"prismjs-okaidia copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-javascript \">\n\t\t\t\t<code readonly=\"true\" class=\"language-javascript\">\n\t\t\t\t\t<xmp>errors {\n  __typename\n  ... on Problem {\n    message\n  }\n}<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-3fe524c elementor-widget elementor-widget-text-editor\" data-id=\"3fe524c\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<pre style=\"overflow: auto; margin-top: 0px; margin-bottom: 0px; color: #ffffff; box-sizing: border-box; font-size: 16px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;\"> <span style=\"color: #212121; text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\">For example, for the company create mutation:<\/span><\/pre>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-9ca550f elementor-widget elementor-widget-code-highlight\" data-id=\"9ca550f\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"prismjs-okaidia copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-javascript \">\n\t\t\t\t<code readonly=\"true\" class=\"language-javascript\">\n\t\t\t\t\t<xmp>{ \"query\": \"mutation { company { create( input: { ownerIds: [\\\"Space caracter is not allow here\\\"], name: \\\"Moovago\\\", city: \\\"Niort\\\", address: \\\"46 Rue du 14 Juillet\\\", postalCode: \\\"79000\\\", phone: \\\"07 68 45 46 74\\\", email: \\\"support@moovago.com\\\", note: \\\"L application du commercial\\\" } ) { recordId errors { __typename ... on Problem { message } } } } }\" }\n<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-eef8856 elementor-widget elementor-widget-text-editor\" data-id=\"eef8856\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<pre style=\"overflow: auto; margin-top: 0px; margin-bottom: 0px; color: #ffffff; box-sizing: border-box; font-size: 16px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;\"><span style=\"color: #212121; text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\">and the response containing a <em>MalformedParameterProblem<\/em> error with a text message describing the error in more detail:<\/span><\/pre>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-b55d558 elementor-widget elementor-widget-code-highlight\" data-id=\"b55d558\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"code-highlight.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"prismjs-okaidia copy-to-clipboard \">\n\t\t\t<pre data-line=\"\" class=\"highlight-height language-javascript \">\n\t\t\t\t<code readonly=\"true\" class=\"language-javascript\">\n\t\t\t\t\t<xmp>{\n  \"data\": {\n    \"company\": {\n      \"create\": {\n        \"recordId\": null,\n        \"errors\": [\n          {\n            \"__typename\": \"MalformedParameterProblem\",\n            \"message\": \"An input parameter is empty, or contains an illegal character.\"\n          }\n        ]\n      }\n    }\n  },\n  \"errors\": null\n}<\/xmp>\n\t\t\t\t<\/code>\n\t\t\t<\/pre>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-5173133 elementor-widget elementor-widget-text-editor\" data-id=\"5173133\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><strong>HTTP response codes<\/strong><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-565afd3 e-flex e-con-boxed e-con e-parent\" data-id=\"565afd3\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t<div class=\"elementor-element elementor-element-0da5205 e-con-full e-flex e-con e-child\" data-id=\"0da5205\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t<div class=\"elementor-element elementor-element-2fe2a7e elementor-widget elementor-widget-text-editor\" data-id=\"2fe2a7e\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>It is also possible for the Moovago server to return conventional<br>HTTP codes to indicate the success or failure of a request.<\/p><p>In general, <span style=\"background-color: rgba(226, 238, 240, 0.6); color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; text-align: var(--text-align);\">2xx<\/span><span style=\"color: var( --e-global-color-text ); text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\"> codes <\/span>indicate<span style=\"color: var( --e-global-color-text ); text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\"> success (unless the <\/span><span style=\"caret-color: #1d1f21; color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6); text-align: var(--text-align);\">errors<\/span><span style=\"color: var( --e-global-color-text ); text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\"> table <\/span><span style=\"font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size ); text-align: var(--text-align);\"> is not empty).<\/span><\/p><p><span style=\"background-color: rgba(226, 238, 240, 0.6); color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; text-align: var(--text-align);\">4xx<\/span><span style=\"color: var( --e-global-color-text ); text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\"> code <\/span>indicate<span style=\"color: var( --e-global-color-text ); text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\"> that an error has occurred idue to the data <\/span>provided<span style=\"color: var( --e-global-color-text ); text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\">.<\/span> <\/p><p><span style=\"text-align: var(--text-align); background-color: rgba(226, 238, 240, 0.6); color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px;\">5xx<\/span><span style=\"color: var( --e-global-color-text ); text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\"> codes <\/span>indicate<span style=\"color: var( --e-global-color-text ); text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\"> an error originating from the Moovago servers.<br><\/span><\/p><p><span style=\"color: var( --e-global-color-text ); text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\"> <\/span><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-6eb78a6 e-con-full e-flex e-con e-child\" data-id=\"6eb78a6\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t<div class=\"elementor-element elementor-element-ca8e5e8 e-con-full e-flex e-con e-child\" data-id=\"ca8e5e8\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t<div class=\"elementor-element elementor-element-11f20db elementor-widget__width-initial elementor-widget elementor-widget-text-editor\" data-id=\"11f20db\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><span style=\"color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">200<\/span><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-f8ddc44 elementor-widget__width-initial elementor-widget elementor-widget-text-editor\" data-id=\"f8ddc44\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><b>Ok<\/b><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-1de1e3e elementor-widget__width-initial elementor-widget elementor-widget-text-editor\" data-id=\"1de1e3e\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>Everything went according to plan.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-a19840a e-con-full e-flex e-con e-child\" data-id=\"a19840a\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t<div class=\"elementor-element elementor-element-3b1c347 elementor-widget__width-initial elementor-widget elementor-widget-text-editor\" data-id=\"3b1c347\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><span style=\"color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">429<\/span><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-f282dad elementor-widget__width-initial elementor-widget elementor-widget-text-editor\" data-id=\"f282dad\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><b>Too Many Requests<\/b><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-ac7576c elementor-widget__width-initial elementor-widget elementor-widget-text-editor\" data-id=\"ac7576c\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>Too many requests reached the API too quickly. ( 5 requests max \/ second). <\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-416fa7e e-con-full e-flex e-con e-child\" data-id=\"416fa7e\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t<div class=\"elementor-element elementor-element-fe73f94 elementor-widget__width-initial elementor-widget elementor-widget-text-editor\" data-id=\"fe73f94\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><span style=\"color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">5xx<\/span><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-9885824 elementor-widget__width-initial elementor-widget elementor-widget-text-editor\" data-id=\"9885824\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><b>Server Errors<\/b><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-07b83ec elementor-widget__width-initial elementor-widget elementor-widget-text-editor\" data-id=\"07b83ec\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>Something has gone wrong on the Moovago server.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-cb316c7 e-flex e-con-boxed e-con e-parent\" data-id=\"cb316c7\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t\t\t<div class=\"elementor-element elementor-element-1e63359 elementor-widget elementor-widget-heading\" data-id=\"1e63359\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h2 class=\"elementor-heading-title elementor-size-default\">Uses, limits and quotas<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-bbbdd73 elementor-widget elementor-widget-text-editor\" data-id=\"bbbdd73\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>For your first tests, we suggest you import some of your data one by one, to test and make sure each time that the data has been imported with the right values, and in the right fields.  <span style=\"text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\">And only then import all your data en masse, at a reasonable rate (ideally 1 query max \/ second).<\/span><\/p><p><span style=\"text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\">Server limits for the API are currently set at :<\/span><\/p><ul><li><span style=\"text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size );\">1 request at a time<\/span><\/li><li><span style=\"font-family: var( --e-global-typography-text-font-family ); font-size: var( --e-global-typography-text-font-size ); text-align: var(--text-align);\">5 requests max \/ second<\/span><\/li><\/ul><p> <\/p><p><span style=\"font-size: var( --e-global-typography-text-font-size ); text-align: var(--text-align); font-family: var( --e-global-typography-text-font-family );\">If this limit is exceeded, the server will respond with a status code <\/span><span style=\"text-align: var(--text-align); color: #1d1f21; font-family: Consolas, Monaco, 'Courier New', monospace; font-size: 14px; font-weight: 600; letter-spacing: 0.32px; background-color: rgba(226, 238, 240, 0.6);\">429 Too Many Requests<\/span><\/p><p>On the Production server, please program your mass processing to take place <strong>outside the<\/strong> following times:<br>Monday to Friday, 8am to 6.30pm<\/p><p> <\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-024e058 e-flex e-con-boxed e-con e-parent\" data-id=\"024e058\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t\t\t<div class=\"elementor-element elementor-element-e02cb97 elementor-widget elementor-widget-heading\" data-id=\"e02cb97\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h2 class=\"elementor-heading-title elementor-size-default\"><span>API updates<\/span><\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-891201d elementor-widget elementor-widget-text-editor\" data-id=\"891201d\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>The Moovago API regularly evolves to offer new features, usually without affecting your connector. Occasionally, however, we may have to deprecate certain elements of the API. These elements are then marked as deprecated in our reference documentation for a few months, so that you have time to update your connector. Deprecated elements are eventually removed completely.   <\/p><p>It is your responsibility to maintain and keep your connector up to date. You must stop using deprecated elements before they are removed, otherwise your connector will stop working. <\/p><p> <\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t","protected":false},"excerpt":{"rendered":"<p>Getting started with the API API documentation Welcome to the Moovago API Getting Started Guide! The Moovago API allows you to create\/read\/modify\/delete your various data stored in Moovago, in a programmatic way (= data exchange with your ERP, your servers&#8230;). This guide shows you how to configure and use our API. The elements currently offered [&hellip;]<\/p>\n","protected":false},"author":6,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"elementor_header_footer","meta":{"footnotes":""},"class_list":["post-49394","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/moovago.com\/en\/wp-json\/wp\/v2\/pages\/49394","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/moovago.com\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/moovago.com\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/moovago.com\/en\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/moovago.com\/en\/wp-json\/wp\/v2\/comments?post=49394"}],"version-history":[{"count":3,"href":"https:\/\/moovago.com\/en\/wp-json\/wp\/v2\/pages\/49394\/revisions"}],"predecessor-version":[{"id":51595,"href":"https:\/\/moovago.com\/en\/wp-json\/wp\/v2\/pages\/49394\/revisions\/51595"}],"wp:attachment":[{"href":"https:\/\/moovago.com\/en\/wp-json\/wp\/v2\/media?parent=49394"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}