> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maesn.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create contact

## Field support per integration

<AccordionGroup>
  <Accordion title="AbaConnect" icon={<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" transform="translate(-7,-4)" viewBox="0 0 192.756 192.756"><g fill-rule="evenodd" clip-rule="evenodd"><path fill="#fff" d="M0 0h192.756v192.756H0V0z"/><path d="M8.504 151.836h113.885c30.502 0 61.863-32.142 61.863-62.644V40.92H72.085c-30.498 0-63.582 32.458-63.582 62.956v47.96h.001z" fill="#cc212f"/><path d="M132.768 132.909c2.086 2.641 5.861 5.184 9.475 5.184 6.479 0 9.035-4.062 9.035-7.191 0-3.173-1.852-4.979-5.641-5.685l-4.627-.881c-1.758-.335-2.561-.883-2.561-2.16 0-1.719 1.896-2.603 3.879-2.603 1.498 0 3.309.312 5.557 2.207l2.6-3.217c-2.91-2.071-5.336-2.779-8.289-2.779-5.332 0-7.982 3.22-7.982 6.833 0 3.04 1.115 4.921 7.105 6.037l2.6.484c1.674.309 2.775 1.058 2.775 2.468 0 1.19-1.586 2.688-4.229 2.688-2.381 0-5.545-2.276-6.742-4.386l-2.955 3.001zm-20.872-4.387c0 5.992 4.672 9.57 9.738 9.57 5.068 0 9.738-3.578 9.738-9.57v-12.339h-4.582v11.942c0 3.129-2.291 5.375-5.156 5.375-2.863 0-5.156-2.246-5.156-5.375v-11.942l-4.582 2.239v10.1zm-2.193-7.222c-1.67-2.854-4.906-5.802-9.453-5.728-7.023.117-11.07 5.813-11.077 11.275-.005 5.42 3.533 10.803 10.854 11.218 4.441.252 7.848-2.583 10.102-6.15l-3.797-2.219c-1.527 2.402-3.42 4.439-6.49 3.99-3.432-.506-5.821-3.365-5.821-6.839 0-3.653 2.633-6.889 6.362-6.897 2.752-.008 4.084 1.533 5.363 3.249l3.957-1.899zm-67.827 16.212l4.343-1.997v-.603h.084c1.044 1.763 3.758 3.181 6.598 3.181 5.261 0 10.524-4.106 10.524-11.245 0-7.138-5.263-11.237-10.524-11.237-2.84 0-5.554 1.411-6.598 3.174h-.084v-9.569h-4.343v28.296zm16.955-10.664c0 3.966-2.672 6.919-6.305 6.919s-6.306-2.953-6.306-6.919 2.673-6.918 6.306-6.918 6.305 2.952 6.305 6.918zm-24.828 10.664h4.583v-21.328l-4.583 2.168v.433h-.088c-1.189-1.808-3.613-3.174-6.786-3.174-6.918 0-11.281 5.993-11.281 11.237 0 5.508 4.055 11.245 11.061 11.245 2.909 0 5.552-1.241 7.006-3.181h.088v2.6zm-13.307-10.664c0-3.833 3.085-6.918 6.786-6.918 3.613 0 6.698 3.085 6.698 6.918 0 3.834-3.085 6.919-6.698 6.919-3.701 0-6.786-3.085-6.786-6.919zm61.802 10.664h4.583v-21.328l-4.583 2.168v.433h-.088c-1.189-1.808-3.613-3.174-6.786-3.174-6.918 0-11.281 5.993-11.281 11.237 0 5.508 4.054 11.245 11.061 11.245 2.908 0 5.552-1.241 7.006-3.181h.088v2.6zM69.19 126.848c0-3.833 3.084-6.918 6.786-6.918 3.613 0 6.698 3.085 6.698 6.918 0 3.834-3.084 6.919-6.698 6.919-3.702 0-6.786-3.085-6.786-6.919z" fill="#fff"/></g></svg>}>
    <Note>
      This endpoint is **[asynchronous](/async-task)**. If the request has not completed, the response returns a `taskId`. Use `/asyncTask/{taskId}` to check the task status and obtain the final result once it is ready.
    </Note>

    Supported Request Parameters:

    <ResponseField name="addresses" type="Address[]">
      <Expandable title="properties">
        <ResponseField name="addressLine1" type="string" />

        <ResponseField name="postalCode" type="string" />

        <ResponseField name="city" type="string" />

        <ResponseField name="countryCode" type="enum">
          Available options (ISO 3166-1 alpha-2):

          `AD`, `AE`, `AF`, `AG`, `AI`, `AL`, `AM`, `AO`, `AQ`, `AR`, `AS`, `AT`, `AU`, `AW`, `AX`, `AZ`, `BA`, `BB`, `BD`, `BE`, `BF`, `BG`, `BH`, `BI`, `BJ`, `BL`, `BM`, `BN`, `BO`, `BQ`, `BR`, `BS`, `BT`, `BV`, `BW`, `BY`, `BZ`, `CA`, `CC`, `CD`, `CF`, `CG`, `CH`, `CI`, `CK`, `CL`, `CM`, `CN`, `CO`, `CR`, `CU`, `CV`, `CW`, `CX`, `CY`, `CZ`, `DE`, `DJ`, `DK`, `DM`, `DO`, `DZ`, `EC`, `EE`, `EG`, `EH`, `ER`, `ES`, `ET`, `FI`, `FJ`, `FK`, `FM`, `FO`, `FR`, `GA`, `GB`, `GD`, `GE`, `GF`, `GG`, `GH`, `GI`, `GL`, `GM`, `GN`, `GP`, `GQ`, `GR`, `GS`, `GT`, `GU`, `GW`, `GY`, `HK`, `HM`, `HN`, `HR`, `HT`, `HU`, `ID`, `IE`, `IL`, `IM`, `IN`, `IO`, `IQ`, `IR`, `IS`, `IT`, `JE`, `JM`, `JO`, `JP`, `KE`, `KG`, `KH`, `KI`, `KM`, `KN`, `KP`, `KR`, `KW`, `KY`, `KZ`, `LA`, `LB`, `LC`, `LI`, `LK`, `LR`, `LS`, `LT`, `LU`, `LV`, `LY`, `MA`, `MC`, `MD`, `ME`, `MF`, `MG`, `MH`, `MK`, `ML`, `MM`, `MN`, `MO`, `MP`, `MQ`, `MR`, `MS`, `MT`, `MU`, `MV`, `MW`, `MX`, `MY`, `MZ`, `NA`, `NC`, `NE`, `NF`, `NG`, `NI`, `NL`, `NO`, `NP`, `NR`, `NU`, `NZ`, `OM`, `PA`, `PE`, `PF`, `PG`, `PH`, `PK`, `PL`, `PM`, `PN`, `PR`, `PT`, `PW`, `PY`, `QA`, `RE`, `RO`, `RS`, `RU`, `RW`, `SA`, `SB`, `SC`, `SD`, `SE`, `SG`, `SH`, `SI`, `SJ`, `SK`, `SL`, `SM`, `SN`, `SO`, `SR`, `SS`, `ST`, `SV`, `SX`, `SY`, `SZ`, `TC`, `TD`, `TF`, `TG`, `TH`, `TJ`, `TK`, `TL`, `TM`, `TN`, `TO`, `TR`, `TT`, `TV`, `TW`, `TZ`, `UA`, `UG`, `UM`, `US`, `UY`, `UZ`, `VA`, `VC`, `VE`, `VG`, `VI`, `VN`, `VU`, `WF`, `WS`, `YE`, `YT`, `ZA`, `ZM`, `ZW`
        </ResponseField>

        <ResponseField name="type" type="enum">
          Available options: `BILLING`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="companyName" type="string" />

    <ResponseField name="contactType" type="enum" required>
      Available options: `CONTACT_PERSON`, `COMPANY`
    </ResponseField>

    <ResponseField name="contactPersons" type="ContactPerson[]">
      <Expandable title="properties">
        <ResponseField name="firstName" type="string" />

        <ResponseField name="lastName" type="string" />

        <ResponseField name="emailAddresses" type="EmailAddress[]">
          <Expandable title="properties">
            <ResponseField name="email" type="string" />

            <ResponseField name="type" type="enum">
              Available options: `BUSINESS`
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="phoneNumbers" type="PhoneNumber[]">
          <Expandable title="properties">
            <ResponseField name="number" type="string" />

            <ResponseField name="type" type="enum">
              Available options: `BUSINESS`, `MOBILE`
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="emailAddresses" type="EmailAddress[]">
      <Expandable title="properties">
        <ResponseField name="email" type="string" />

        <ResponseField name="type" type="enum">
          Available options: `BUSINESS`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="number" type="string" required />

    <ResponseField name="phoneNumbers" type="PhoneNumber[]">
      <Expandable title="properties">
        <ResponseField name="number" type="string" />

        <ResponseField name="type" type="enum">
          Available options: `BUSINESS`, `PRIVATE`
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Accordion>

  <Accordion title="bexio" icon={<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" transform="translate(-8, -8)" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" heigh="10" width="45" viewBox="20 -20 999 999" enable-background="new 0 0 888 888" xml:space="preserve" ><path fill="#BBDC00" d=""/><path class="st0" fill="#BBDC00" d="M382.3,346.6l37.8-51.1c2-3.1,2-7.1,0-10.2c-1.5-2-4.1-3.1-8.2-3.1h-7.1c-3.1,0-6.1,1.5-7.7,4.1l-29.6,40.3l-29.1-39.8c-2-3.1-5.6-4.6-9.7-4.6H323c-3.6,0-6.1,1-8.2,3.1c-2.6,3.1-2.6,7.1,0,10.2l37.8,51.1l-41.9,57.2c-2,3.1-2,7.1,0.5,10.2c1.5,2,4.1,3.1,6.6,3.1h8.7c2.6,0,5.1-1.5,6.6-3.6l34.2-47l34.2,46.5c2,2.6,4.6,4.1,7.7,4.1h8.7c3.1,0,6.1-1.5,7.7-4.6c1.5-3.1,1-6.1-0.5-8.7L382.3,346.6L382.3,346.6z M453.8,282.3h-1.5c-6.6,0-11.2,4.6-11.2,10.2v113.9c0,5.6,4.6,10.2,10.2,10.2h3.6c5.6,0,10.2-4.6,10.2-10.2V292.5C465.5,286.4,460.4,282.3,453.8,282.3z M600.3,299.6c-13.3-13.3-30.1-20.4-49-20.4c-19.4,0-35.7,6.6-49,20.4c-13.3,13.3-19.9,30.1-19.9,49.5c0,19.4,6.6,36.3,19.9,49.5c13.3,13.3,29.6,20.4,49,20.4c19.4,0,35.7-6.6,49-20.4c13.3-13.3,19.9-30.1,19.9-49.5C620.7,329.8,614.1,312.9,600.3,299.6z M520.1,316.5c8.7-9.2,18.9-13.3,31.7-13.3s23,4.1,31.7,13.3s12.8,19.9,12.8,32.7c0,13.3-4.1,24-12.8,32.7c-8.7,8.7-18.9,13.3-31.7,13.3s-23-4.1-31.1-13.3c-8.7-8.7-12.8-19.9-12.8-33.2C507.4,335.9,511.5,325.7,520.1,316.5z M303.6,354.3c2.6-3.1,4.1-6.6,3.6-10.7c-1-16.9-8.2-31.7-19.9-43.4c-13.3-13.3-30.1-20.4-49-20.4c-19.4,0-35.7,6.6-49,20.4c-13.3,13.3-19.9,30.1-19.9,49.5s6.6,36.3,19.9,49.5c13.3,13.3,29.6,20.4,49,20.4c18.9,0,35.7-6.6,49-20.4c5.1-5.1,9.2-11.7,12.3-16.9c1-2,1-4.6,0-6.6c-1.5-2-3.6-3.6-6.6-3.6h-8.7c-5.1,0-7.1,1-8.2,3.1c-1.5,2.6-3.6,5.1-5.6,7.1c-8.7,8.7-18.9,13.3-31.7,13.3c-12.8,0-23-4.1-31.1-13.3c-6.6-6.6-10.7-14.8-11.7-24h97.5C297.5,358.9,301.1,356.8,303.6,354.3z M238.8,303.7c12.8,0,23,4.1,31.7,13.3c5.6,5.6,9.2,11.7,10.7,18.4h-84.8c2-6.6,5.6-12.8,10.7-18.4C215.8,307.8,226,303.7,238.8,303.7z M88.7,279.7c-16.9,0-32.2,5.6-44.4,16.3v-61.8c0-5.6-4.6-9.7-11.2-9.7h-1.5c-6.6,0-11.2,4.1-11.2,9.7v115.4c0,19.4,6.6,36.3,19.9,49.5c13.3,13.3,29.6,20.4,49,20.4s35.7-6.6,49-20.4c13.3-13.3,19.9-30.1,19.9-49.5s-6.6-36.3-19.9-49.5C124.4,286.4,108.1,279.7,88.7,279.7z M88.7,395.6c-12.8,0-23-4.1-31.1-13.3c-8.7-8.7-12.8-19.9-12.8-33.2c0-12.8,4.1-23.5,12.3-32.7c8.7-8.7,18.9-13.3,31.7-13.3s23,4.1,31.7,13.3s12.8,19.9,12.8,32.7c0,13.3-4.1,24-12.8,32.7C111.7,391,101.4,395.6,88.7,395.6z M453.3,226.6c-9.2,0-16.9,7.7-16.9,16.9s7.7,16.9,16.9,16.9c9.2,0,16.9-7.7,16.9-16.9S462.4,226.6,453.3,226.6z"/></svg>}>
    Supported Request Parameters:

    <ResponseField name="addresses" type="Address[]">
      <Expandable title="properties">
        <ResponseField name="addressLine1" type="string" />

        <ResponseField name="postalCode" type="string" />

        <ResponseField name="city" type="string" />

        <ResponseField name="countryCode" type="enum">
          Available options (ISO 3166-1 alpha-2):

          `AD`, `AE`, `AF`, `AG`, `AI`, `AL`, `AM`, `AO`, `AQ`, `AR`, `AS`, `AT`, `AU`, `AW`, `AX`, `AZ`, `BA`, `BB`, `BD`, `BE`, `BF`, `BG`, `BH`, `BI`, `BJ`, `BL`, `BM`, `BN`, `BO`, `BQ`, `BR`, `BS`, `BT`, `BV`, `BW`, `BY`, `BZ`, `CA`, `CC`, `CD`, `CF`, `CG`, `CH`, `CI`, `CK`, `CL`, `CM`, `CN`, `CO`, `CR`, `CU`, `CV`, `CW`, `CX`, `CY`, `CZ`, `DE`, `DJ`, `DK`, `DM`, `DO`, `DZ`, `EC`, `EE`, `EG`, `EH`, `ER`, `ES`, `ET`, `FI`, `FJ`, `FK`, `FM`, `FO`, `FR`, `GA`, `GB`, `GD`, `GE`, `GF`, `GG`, `GH`, `GI`, `GL`, `GM`, `GN`, `GP`, `GQ`, `GR`, `GS`, `GT`, `GU`, `GW`, `GY`, `HK`, `HM`, `HN`, `HR`, `HT`, `HU`, `ID`, `IE`, `IL`, `IM`, `IN`, `IO`, `IQ`, `IR`, `IS`, `IT`, `JE`, `JM`, `JO`, `JP`, `KE`, `KG`, `KH`, `KI`, `KM`, `KN`, `KP`, `KR`, `KW`, `KY`, `KZ`, `LA`, `LB`, `LC`, `LI`, `LK`, `LR`, `LS`, `LT`, `LU`, `LV`, `LY`, `MA`, `MC`, `MD`, `ME`, `MF`, `MG`, `MH`, `MK`, `ML`, `MM`, `MN`, `MO`, `MP`, `MQ`, `MR`, `MS`, `MT`, `MU`, `MV`, `MW`, `MX`, `MY`, `MZ`, `NA`, `NC`, `NE`, `NF`, `NG`, `NI`, `NL`, `NO`, `NP`, `NR`, `NU`, `NZ`, `OM`, `PA`, `PE`, `PF`, `PG`, `PH`, `PK`, `PL`, `PM`, `PN`, `PR`, `PT`, `PW`, `PY`, `QA`, `RE`, `RO`, `RS`, `RU`, `RW`, `SA`, `SB`, `SC`, `SD`, `SE`, `SG`, `SH`, `SI`, `SJ`, `SK`, `SL`, `SM`, `SN`, `SO`, `SR`, `SS`, `ST`, `SV`, `SX`, `SY`, `SZ`, `TC`, `TD`, `TF`, `TG`, `TH`, `TJ`, `TK`, `TL`, `TM`, `TN`, `TO`, `TR`, `TT`, `TV`, `TW`, `TZ`, `UA`, `UG`, `UM`, `US`, `UY`, `UZ`, `VA`, `VC`, `VE`, `VG`, `VI`, `VN`, `VU`, `WF`, `WS`, `YE`, `YT`, `ZA`, `ZM`, `ZW`
        </ResponseField>

        <ResponseField name="type" type="enum">
          Available options: `BILLING`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="companyName" type="string" />

    <ResponseField name="contactPersons" type="ContactPerson[]">
      <Note>
        Please note that bexio doesn't allow contact persons for a company.
      </Note>

      <Expandable title="properties">
        <ResponseField name="salutation" type="string">
          Available options: `Frau`, `Herr`, `Familie`, `Herr & Frau`
        </ResponseField>

        <ResponseField name="firstName" type="string" />

        <ResponseField name="lastName" type="string" required />

        <ResponseField name="emailAddresses" type="string[]" />

        <ResponseField name="phoneNumbers" type="string[]" />
      </Expandable>
    </ResponseField>

    <ResponseField name="contactType" type="enum" required>
      Available options: `CONTACT_PERSON`, `COMPANY`
    </ResponseField>

    <ResponseField name="emailAddresses" type="EmailAddress[]">
      <Expandable title="properties">
        <ResponseField name="email" type="string" />

        <ResponseField name="type" type="enum">
          Available options: `BUSINESS`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="phoneNumbers" type="PhoneNumber[]">
      <Expandable title="properties">
        <ResponseField name="number" type="string" />

        <ResponseField name="type" type="enum">
          Available options: `BUSINESS`, `MOBILE`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="website" type="string" />
  </Accordion>

  <Accordion title="Exact Online" icon={<div dangerouslySetInnerHTML={{__html: `<svg width="24" height="24" viewBox="0 0 842 179" transform="translate(-7,-4)" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"><defs><path id="a" d="M.06.529h841.83V178.94H.06z"/></defs><g fill="none" fill-rule="evenodd"><mask id="b" fill="#fff"><use xlink:href="#a"/></mask><path fill="#D9252A" mask="url(https://mintlify.s3.us-west-1.amazonaws.com/maesn/api-reference/accounting-endpoints/contacts#b)" d="M112.97 58.348H0v33.794h128.574V58.348H112.97M111.616 116.693H0v33.794h16.958v-.001h94.658v.001h16.958v-33.794h-16.958M566.017 146.261h-50.69c-8.447 0-13.465-4.492-13.465-12.677 0-8.181 5.018-12.668 13.465-12.668h50.69v25.345zM542.521 29.045h-46.878v-.001h-20.734v33.791h20.734v-.001h44.761c20.032 0 25.448 7.694 25.603 25.346H513.74c-30.887 0-47.784 15.84-47.784 45.404 0 29.31 16.897 45.414 47.784 45.414h82.11l.032-.002h6.566v-92.13c0-39.079-14.785-57.821-59.927-57.821zM732.45 145.204h-42.503c-22.97 0-31.424-11.086-31.424-41.181 0-30.094 8.454-41.185 31.424-41.185h41.973l.065-.003h6.556V29.044h-52.293c-46.724 0-64.681 23.233-64.681 74.979 0 51.742 17.957 74.973 64.681 74.973h52.796v-33.791h-6.562l-.032-.001M269.888 145.205h-39.992c-19.092 0-27.963-6.758-30.417-23.753h59.03v.022h20.732v-6.021c.014-.2.026-.401.026-.609V94.253c0-.207-.012-.409-.026-.609v-5.961h-5.827a8.685 8.685 0 0 0-.747-.033h-73.324c2.254-17.607 11.101-24.815 30.553-24.815h60.194V29.044h-18.099v.003h-45.789c-46.733 0-64.677 23.228-64.677 74.973 0 51.741 17.944 74.979 64.677 74.979h57.819c.022 0 .043-.002.065-.003h6.535v-33.791h-20.733M835.286 145.205H805.98c-7.125 0-11.358-5.012-11.358-13.99v-68.38h44.091V29.047h-44.091V.529h-36.426v133.323c0 30.894 14.521 45.147 44.616 45.147h32.474l.066-.003h6.538v-33.791h-6.604M456.904 172.136l-53.323-70.381 49.893-65.848v-.001l5.199-6.862h-42.787l-3.597 4.749-.001.001-30.095 39.725-30.1-39.725-.001-.002-3.598-4.748h-44.367l55.879 73.758-57.729 76.197 14.575-.003h28.211l3.598-4.747.002-.002 32.737-43.209 32.738 43.209v.001l3.598 4.748h44.367l-5.199-6.86"/></g></svg>`,}}/>}>
    <Note>
      If you're not using the [Interactive Authentication Flow](/authentication#interactive-authentication-flow), make sure the query parameter `companyId` is correctly populated.
      You can obtain this value by using the `GET Companies` endpoint available under the Authentication section.
    </Note>

    Supported Request Parameters:

    <ResponseField name="addresses" type="Address[]">
      <Expandable title="properties">
        <ResponseField name="addressLine1" type="string" />

        <ResponseField name="addressLine2" type="string" />

        <ResponseField name="city" type="string" />

        <ResponseField name="countryCode" type="enum">
          The country code in ISO 3166-1 alpha-2 format. For a complete list of available values, see our [standardized data](/standardization) section.
        </ResponseField>

        <ResponseField name="postalCode" type="string" />

        <ResponseField name="type" type="enum">
          Available options: `BILLING`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="companyName" type="string" required />

    <ResponseField name="contactPersons" type="ContactPerson[]">
      <Expandable title="properties">
        <ResponseField name="salutation" type="string" />

        <ResponseField name="firstName" type="string" required />

        <ResponseField name="lastName" type="string" required />

        <ResponseField name="emailAddresses" type="EmailAddress[]">
          <Expandable title="properties">
            <ResponseField name="email" type="string" />

            <ResponseField name="type" type="enum">
              Available options: `BUSINESS`
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="phoneNumbers" type="PhoneNumber[]">
          <Expandable title="properties">
            <ResponseField name="number" type="string" />

            <ResponseField name="type" type="enum">
              Available options: `BUSINESS`, `MOBILE`
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="contactType" type="enum" required>
      Available options:`COMPANY`
    </ResponseField>

    <ResponseField name="emailAddresses" type="EmailAddress[]">
      <Expandable title="properties">
        <ResponseField name="email" type="string" />

        <ResponseField name="type" type="enum">
          Available options: `BUSINESS`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="isCustomer" type="boolean" />

    <ResponseField name="isSupplier" type="boolean" />

    <ResponseField name="phoneNumbers" type="PhoneNumber[]">
      <Expandable title="properties">
        <ResponseField name="number" type="string" />

        <ResponseField name="type" type="enum">
          Available options: `BUSINESS`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="website" type="string" />
  </Accordion>

  <Accordion title="Moneybird" icon={<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" height="18" width="22"><rect width="512" height="512" rx="15%" fill="#0075dd"/><path fill="#fff" d="M168 154c-26-2-63-11-83-20-11 73 10 118 37 141-3 64 64 122 138 122 69 0 134-44 143-116 0 0 27-6 27-18 0-13-25-17-27-18-10-65-58-91-118-91H191c-13 0-26 0-39-1zm181 60a18 18 0 1 1 0 36 18 18 0 0 1 0-36z"/></svg>}>
    <Note>
      If you're not using the [Interactive Authentication Flow](/authentication#interactive-authentication-flow), make sure the query parameter `companyId` is correctly populated.
      You can obtain this value by using the `GET Companies` endpoint available under the Authentication section.
    </Note>

    Supported Request Parameters:

    <ResponseField name="addresses" type="Address[]">
      <Expandable title="properties">
        <ResponseField name="addressLine1" type="string" />

        <ResponseField name="addressLine2" type="string" />

        <ResponseField name="city" type="string" />

        <ResponseField name="countryCode" type="enum">
          The country code in ISO 3166-1 alpha-2 format. For a complete list of available values, see our [standardized data](/standardization) section.
        </ResponseField>

        <ResponseField name="postalCode" type="string" />

        <ResponseField name="type" type="enum">
          Available options: `BILLING`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="companyName" type="string" required />

    <ResponseField name="contactPersons" type="ContactPerson[]">
      <Expandable title="properties">
        <ResponseField name="firstName" type="string" required />

        <ResponseField name="lastName" type="string" required />

        <ResponseField name="emailAddresses" type="EmailAddress[]">
          <Expandable title="properties">
            <ResponseField name="email" type="string" />

            <ResponseField name="type" type="enum">
              Available options: `BUSINESS`
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="phoneNumbers" type="PhoneNumber[]">
          <Expandable title="properties">
            <ResponseField name="number" type="string" />

            <ResponseField name="type" type="enum">
              Available options: `BUSINESS`
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="contactType" type="enum" required>
      Available options:`COMPANY`, `CONTACT_PERSON`
    </ResponseField>

    <ResponseField name="emailAddresses" type="EmailAddress[]">
      <Expandable title="properties">
        <ResponseField name="email" type="string" />

        <ResponseField name="type" type="enum">
          Available options: `BUSINESS`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="phoneNumbers" type="PhoneNumber[]">
      <Expandable title="properties">
        <ResponseField name="number" type="string" />

        <ResponseField name="type" type="enum">
          Available options: `BUSINESS`
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Accordion>

  <Accordion title="Snelstart" icon={<svg width="27" height="24" viewBox="0 0 170 28"  transform="translate(-8, -4)" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0 28H28V25.6842H0V28Z" fill="#FA6102"/><path fill-rule="evenodd" clip-rule="evenodd" d="M28 0V24.2105H0V0H28ZM14 17.4225L20.0325 21.0428L18.439 14.2548L23.7886 9.72946L16.7317 9.1638L14.2276 2.7152L11.2683 9.1638L4.21138 9.72946L9.56098 14.2548L7.96748 21.0428L14 17.4225Z" fill="#0078C9"/><path d="M34.6673 19.8542C35.5666 20.5314 37.3653 21.0958 38.9392 21.0958C41.2999 21.0958 42.4241 19.967 42.4241 18.3868C42.4241 16.8066 41.5247 16.0165 39.164 15.1135C36.0163 13.9848 34.4425 12.1788 34.4425 10.0342C34.4425 7.21243 36.8032 4.84211 40.6254 4.84211C42.4241 4.84211 43.9979 5.40647 45.0097 5.97083L44.2228 8.34115C43.5483 7.88966 42.1992 7.3253 40.6254 7.3253C38.7143 7.3253 37.5902 8.45403 37.5902 9.8085C37.5902 11.2758 38.6019 11.9531 40.9627 12.8561C43.9979 13.9848 45.6842 15.565 45.6842 18.2739C45.6842 21.4344 43.211 23.5789 39.0516 23.5789C37.1405 23.5789 35.3418 23.1275 34.1052 22.3373L34.6673 19.8542Z" fill="#0078C9"/><path d="M49.798 10.338C49.798 8.53874 49.798 6.96437 49.6843 5.50245H52.6409L52.8683 8.42628H52.9821C53.8918 6.73946 55.9386 5.05263 58.8952 5.05263C61.397 5.05263 65.2633 6.51455 65.2633 12.5871V23.1579H61.9655V12.9245C61.9655 10.1131 60.8284 7.6391 57.7581 7.6391C55.5975 7.6391 53.8918 9.10101 53.3232 10.9003C53.2095 11.3501 53.0958 11.7999 53.0958 12.3622V23.0454H49.798V10.338Z" fill="#0078C9"/><path fill-rule="evenodd" clip-rule="evenodd" d="M78.3674 21.2912C75.0732 21.2912 72.3469 19.4743 72.2333 15.0456V14.9321H84.7286C84.7286 14.7909 84.7481 14.6304 84.7709 14.4422C84.8032 14.1761 84.8422 13.8549 84.8422 13.4558C84.8422 10.1627 83.3655 5.05263 77.4586 5.05263C72.2333 5.05263 69.0527 9.25423 69.0527 14.7049C69.0527 20.1557 72.3469 23.7895 77.913 23.7895C80.8664 23.7895 82.7975 23.2217 83.9335 22.6539L83.3655 20.3828C82.116 20.837 80.7528 21.2912 78.3674 21.2912ZM77.2315 7.32376C80.8664 7.32376 81.7752 10.6169 81.7752 12.6609H72.2333C72.4605 10.3898 73.9372 7.32376 77.2315 7.32376Z" fill="#0078C9"/><path d="M96.8659 18.3553C97.8931 19.0367 100.404 19.718 102.116 19.718C103.828 19.718 104.513 19.1502 104.513 18.2418C104.513 17.3333 103.942 16.8791 101.774 16.1978C98.0073 14.9486 96.5235 12.9046 96.6377 10.747C96.6377 7.34035 99.6051 4.84211 104.056 4.84211C106.225 4.84211 108.051 5.52345 109.192 6.09123V10.2928C108.393 9.8386 105.768 8.81659 104.17 8.81659C102.915 8.58947 102.116 9.15726 102.116 10.0657C102.116 10.9742 102.801 11.3148 105.083 12.1097C108.507 13.2453 109.991 15.0622 110.105 17.674C110.105 21.0807 107.366 23.5789 102.23 23.5789C99.8334 23.5789 98.3497 23.0112 96.9801 22.3298V18.3553H96.8659Z" fill="#FA6102"/><path d="M118.887 0.210526V6.18988H122.947V10.3641H118.887V16.005C118.887 18.1486 119.451 19.1639 121.143 19.1639C121.819 19.1639 122.383 19.0511 122.835 19.0511V23.3382C122.045 23.6767 120.804 23.7895 119.226 23.7895C117.421 23.7895 115.955 23.1126 115.053 22.21C114.038 21.1947 113.474 19.3896 113.474 16.9076V10.3641V6.18988V1.45152L118.887 0.210526Z" fill="#FA6102"/><path fill-rule="evenodd" clip-rule="evenodd" d="M137.45 21.335L137.788 23.1302V23.2424H142.737C142.624 22.2326 142.512 20.5496 142.512 18.8667V12.5837C142.512 8.3202 140.6 4.84211 134.639 4.84211C131.377 4.84211 127.553 6.07627 127.553 6.07627V10.2275C127.553 10.2275 131.827 8.65679 133.626 8.65679C136.326 8.65679 136.888 10.1153 136.888 11.0129V11.2373C130.477 11.2373 126.316 13.4812 126.316 18.0813C126.316 20.8862 128.565 23.5789 132.164 23.5789C134.301 23.5789 136.213 22.7936 137.338 21.335H137.45ZM131.939 17.5203C131.939 15.3886 134.189 14.7154 137.113 14.7154H137.226V16.735C137.226 16.9593 137.226 17.2959 137.113 17.6325C136.776 18.7545 135.538 19.6521 134.189 19.6521C132.952 19.6521 131.939 18.9789 131.939 17.5203Z" fill="#FA6102"/><path d="M169.895 10.3641V6.18988H165.825V0.210526L160.286 1.45152V6.18988H160.173H156.104C154.408 6.18988 152.825 6.07706 151.921 8.67187H151.808V5.40015H146.947C147.06 6.9796 147.06 8.67187 147.06 11.3795V23.451H152.712V14.3128C152.712 13.8615 152.712 13.4102 152.825 13.0718C153.165 11.3795 153.843 10.3641 155.991 10.3641H160.399V16.9076C160.399 19.5024 160.964 21.1947 161.982 22.21C162.886 23.1126 164.356 23.7895 166.164 23.7895C167.747 23.7895 169.103 23.5638 169.782 23.3382V19.0511C169.329 19.1639 168.877 19.1639 168.086 19.1639C166.39 19.1639 165.825 18.1486 165.825 16.005V10.3641H169.895Z" fill="#FA6102"/><path d="M88.842 1.00128V23.3684H91.9999V0.210526L88.842 1.00128Z" fill="#0078C9"/></svg>}>
    Supported Request Parameters:

    <ResponseField name="addresses" type="Address[]">
      <Expandable title="properties">
        <ResponseField name="addressLine1" type="string" />

        <ResponseField name="postalCode" type="string" />

        <ResponseField name="city" type="string" />

        <ResponseField name="countryCode" type="enum" required>
          The country code in ISO 3166-1 alpha-2 format. For a complete list of available values, see our [standardized data](/standardization) section.
        </ResponseField>

        <ResponseField name="type" type="enum">
          Available options: `BILLING`, `DELIVERY`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="companyName" type="string" required />

    <ResponseField name="contactType" type="enum" required>
      Available options: `COMPANY`
    </ResponseField>

    <ResponseField name="emailAddresses" type="EmailAddress[]">
      <Expandable title="properties">
        <ResponseField name="email" type="string" />

        <ResponseField name="type" type="enum">
          Available options:`BUSINESS`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="isCustomer" type="boolean" />

    <ResponseField name="isSupplier" type="boolean" />

    <ResponseField name="number" type="string" />

    <ResponseField name="phoneNumbers" type="PhoneNumber[]">
      <Expandable title="properties">
        <ResponseField name="number" type="string" />

        <ResponseField name="type" type="enum">
          Available options: `BUSINESS`, `MOBILE`
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Accordion>

  <Accordion title="Xero" icon={<svg width="24" height="24" viewBox="0 0 45 46" xmlns="http://www.w3.org/2000/svg" transform="translate(-7,-4)"><path fill="#13B5EA" d="M22.457 45.49c12.402 0 22.456-10.072 22.456-22.495C44.913 10.57 34.86.5 22.457.5 10.054.5 0 10.57 0 22.995 0 35.418 10.054 45.49 22.457 45.49"/><path class="logo-xero-blue__text" fill="#fff" d="M10.75 22.935l3.832-3.85a.688.688 0 0 0-.977-.965l-3.83 3.833-3.845-3.84a.687.687 0 0 0-.966.979l3.832 3.837-3.83 3.84a.688.688 0 1 0 .964.981l3.84-3.842 3.825 3.827a.685.685 0 0 0 1.184-.473.68.68 0 0 0-.2-.485l-3.83-3.846m22.782.003c0 .69.56 1.25 1.25 1.25a1.25 1.25 0 0 0-.001-2.5c-.687 0-1.246.56-1.246 1.25m-2.368 0c0-1.995 1.62-3.62 3.614-3.62 1.99 0 3.613 1.625 3.613 3.62s-1.622 3.62-3.613 3.62a3.62 3.62 0 0 1-3.614-3.62m-1.422 0c0 2.78 2.26 5.044 5.036 5.044s5.036-2.262 5.036-5.043c0-2.78-2.26-5.044-5.036-5.044a5.046 5.046 0 0 0-5.036 5.044m-.357-4.958h-.21c-.635 0-1.247.2-1.758.595a.696.696 0 0 0-.674-.54.68.68 0 0 0-.68.684l.002 8.495a.687.687 0 0 0 1.372-.002v-5.224c0-1.74.16-2.444 1.648-2.63.14-.017.288-.014.29-.014.406-.015.696-.296.696-.675a.69.69 0 0 0-.69-.688m-13.182 4.127c0-.02.002-.04.003-.058a3.637 3.637 0 0 1 7.065.055H16.2zm8.473-.13c-.296-1.403-1.063-2.556-2.23-3.296a5.064 5.064 0 0 0-5.61.15 5.098 5.098 0 0 0-1.973 5.357 5.08 5.08 0 0 0 4.274 3.767c.608.074 1.2.04 1.81-.12a4.965 4.965 0 0 0 1.506-.644c.487-.313.894-.727 1.29-1.222.006-.01.014-.017.022-.027.274-.34.223-.826-.077-1.056-.254-.195-.68-.274-1.014.156-.072.104-.153.21-.24.315-.267.295-.598.58-.994.802-.506.27-1.08.423-1.69.427-1.998-.023-3.066-1.42-3.447-2.416a3.716 3.716 0 0 1-.153-.58l-.01-.105h7.17c.982-.022 1.51-.717 1.364-1.51z"/></svg>}>
    Supported Request Parameters:

    <ResponseField name="addresses" type="Address[]">
      <Expandable title="properties">
        <ResponseField name="addressLine1" type="string" />

        <ResponseField name="addressLine2" type="string" />

        <ResponseField name="postalCode" type="string" />

        <ResponseField name="city" type="string" />

        <ResponseField name="countryCode" type="enum">
          The country code in ISO 3166-1 alpha-2 format. For a complete list of available values, see our [standardized data](/standardization) section.
        </ResponseField>

        <ResponseField name="type" type="enum">
          Available options: `BILLING`, `DELIVERY`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="companyName" type="string" required />

    <ResponseField name="contactPersons" type="ContactPerson[]">
      <Expandable title="properties">
        <ResponseField name="firstName" type="string" />

        <ResponseField name="lastName" type="string" />

        <ResponseField name="emailAddresses" type="EmailAddress[]">
          <Expandable title="properties">
            <ResponseField name="email" type="string" />
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="emailAddresses" type="EmailAddress[]">
      <Expandable title="properties">
        <ResponseField name="email" type="string" />
      </Expandable>
    </ResponseField>

    <ResponseField name="number" type="string" />

    <ResponseField name="phoneNumbers" type="PhoneNumber[]">
      <Expandable title="properties">
        <ResponseField name="number" type="string" />

        <ResponseField name="type" type="enum">
          Available options: `BUSINESS`, `MOBILE`, `FAX`, `OTHER`
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Accordion>
</AccordionGroup>


## OpenAPI

````yaml post /accounting/contacts
openapi: 3.0.0
info:
  title: Maesn unified API
  description: The Maesn unified API description
  version: '1.0'
  contact: {}
servers:
  - url: https://api.maesn.dev
security: []
tags:
  - name: maesn
    description: ''
paths:
  /accounting/contacts:
    post:
      tags:
        - accounting
      operationId: createContact
      parameters:
        - name: X-API-KEY
          description: API key
          in: header
          schema:
            type: string
          required: true
        - name: X-ACCOUNT-KEY
          description: Account key
          in: header
          schema:
            type: string
          required: true
        - name: companyId
          required: false
          in: query
          schema:
            type: string
        - name: environmentName
          in: query
          schema:
            type: string
          required: false
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContactRequestDtoV2'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/BaseResponseDto'
                  - properties:
                      data:
                        $ref: '#/components/schemas/ContactResponseDtoV2'
components:
  schemas:
    ContactRequestDtoV2:
      type: object
      properties:
        id:
          type: string
          example: 92c4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b
        addresses:
          type: array
          items:
            $ref: '#/components/schemas/ContactAddressV2'
        companyName:
          type: string
          example: maesn
        contactPersons:
          type: array
          items:
            $ref: '#/components/schemas/ContactPersonV2'
        contactType:
          type: string
          enum:
            - CONTACT_PERSON
            - COMPANY
          example: CONTACT_PERSON
        emailAddresses:
          type: array
          items:
            $ref: '#/components/schemas/ContactEmailV2'
        isCustomer:
          type: boolean
          example: true
        isSupplier:
          type: boolean
          example: false
        number:
          type: string
          example: '1042'
        phoneNumbers:
          type: array
          items:
            $ref: '#/components/schemas/ContactPhoneV2'
        projectId:
          type: string
          example: '3'
        website:
          type: string
          example: https://www.maesn.com
      required:
        - contactType
    BaseResponseDto:
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/MetaResponse'
        data:
          oneOf:
            - type: object
            - type: array
    ContactResponseDtoV2:
      type: object
      properties:
        id:
          type: string
          example: 92c4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b
        addresses:
          type: array
          items:
            $ref: '#/components/schemas/ContactAddressV2'
        companyName:
          type: string
          example: maesn
        contactPersons:
          type: array
          items:
            $ref: '#/components/schemas/ContactPersonV2'
        contactType:
          type: string
          enum:
            - CONTACT_PERSON
            - COMPANY
          example: CONTACT_PERSON
        createdDate:
          type: string
          example: '2025-06-01T11:09:11.533Z'
        emailAddresses:
          type: array
          items:
            $ref: '#/components/schemas/ContactEmailV2'
        isCustomer:
          type: boolean
          example: true
        isSupplier:
          type: boolean
          example: false
        number:
          type: string
          example: '1042'
        phoneNumbers:
          type: array
          items:
            $ref: '#/components/schemas/ContactPhoneV2'
        projectId:
          type: string
          example: '3'
        updatedDate:
          type: string
          example: '2025-06-01T11:09:11.533Z'
        website:
          type: string
          example: https://www.maesn.com
    ContactAddressV2:
      type: object
      properties:
        addressLine1:
          type: string
          example: Lucky street 1
        addressLine2:
          type: string
          example: 2nd floor
        city:
          type: string
          example: Berlin
        countryCode:
          type: string
          example: DE
        postalCode:
          type: string
          example: '10243'
        type:
          type: string
          enum:
            - BILLING
            - DELIVERY
            - PRIVATE
            - WORK
            - PICKUP
          example: BILLING
    ContactPersonV2:
      type: object
      properties:
        id:
          type: string
          example: 967188f6-8248-4765-b1e8-0f13a3ddb616
        emailAddresses:
          type: array
          items:
            $ref: '#/components/schemas/ContactEmailV2'
        firstName:
          type: string
          example: John
        lastName:
          type: string
          example: Doe
        phoneNumbers:
          type: array
          items:
            $ref: '#/components/schemas/ContactPhoneV2'
        salutation:
          type: string
          example: Mr
    ContactEmailV2:
      type: object
      properties:
        email:
          type: string
          example: john.doe@company.com
        type:
          type: string
          enum:
            - BUSINESS
            - PRIVATE
            - OFFICE
            - INVOICE
            - PAYMENT
            - OTHER
          example: BUSINESS
    ContactPhoneV2:
      type: object
      properties:
        number:
          type: string
          example: +49 7163307056
        type:
          type: string
          enum:
            - BUSINESS
            - MOBILE
            - OFFICE
            - FAX
            - PRIVATE
            - OTHER
          example: MOBILE
    MetaResponse:
      type: object
      properties:
        warnings:
          type: array
          items:
            type: string
            example: Field not used by target system
        pagination:
          $ref: '#/components/schemas/PaginationResponse'
    PaginationResponse:
      type: object
      properties:
        total:
          type: number
          example: 125
        perPage:
          type: number
          example: 50
        currentPage:
          type: number
          example: 1
        totalPages:
          type: number
          example: 3

````