> ## 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 contacts bulk ## Field support per integration }> This endpoints is asynchronous. To check the status of the request, use the `GET asyncTask` endpoint. For more info about asynchronous tasks visit the [`Asynchronous Task`](/async-task) section. If you're not using the [Interactive Authentication Flow](/authentication#interactive-authentication-flow), make sure the query parameter `companyId` is accurately populated with the appropriate company ID. You can obtain this value by using the `GET Companies` endpoint available under the Authentication section. Supported Request Parameters: The `accountNumberLength` field specifies the length of the G/L accounts. The value must match the configuration defined in the end user’s mandate settings within the DATEV application. Available options: `SKR03`, `SKR04`, `SKR42`, `SKR51`, `SKR14` 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` Available options: `BILLING`, `WORK` Important: if the `accountNumber` is already in use, the request will update the existing contact associated with that account number. Available options: `BUSINESS` Available options: `BUSINESS`, `MOBILE` Available options: `CONTACT_PERSON`, `COMPANY` Available options: `BUSINESS` Available options: `BUSINESS`, `MOBILE` YYYY-MM-DD date format, e.g., 2025-01-01 The `fiscalYearStartDate` field should be set to the first day of the fiscal year, which is usually January 1st. If your fiscal year begins on a different date, please adjust this field accordingly. If the provided date does not match the actual fiscal year start date, DATEV will not return an error code. However, the booking entries will not be posted in Rechnungswesen. ## OpenAPI ````yaml post /accounting/contacts/bulk 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/bulk: post: tags: - accounting operationId: create Contacts parameters: - name: companyId required: false in: query schema: type: string - name: X-API-KEY description: API key in: header schema: type: string example: example value required: true - name: X-ACCOUNT-KEY description: Account key in: header schema: type: string example: example value required: true requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateContactByBatchMetaDataDto' responses: '200': description: '' content: application/json: schema: allOf: - $ref: '#/components/schemas/BaseResponseDto' - properties: data: $ref: '#/components/schemas/ContactByBatchMetaDataResponseDto' components: schemas: CreateContactByBatchMetaDataDto: type: object properties: accountNumberLength: type: number example: 4 chartOfAccount: type: string enum: - SKR03 - SKR04 - SKR42 - SKR51 - SKR14 example: SKR03 entries: type: array items: $ref: '#/components/schemas/ContactEntriesRequestDto' fiscalYearStartDate: type: string example: '2025-01-01' BaseResponseDto: type: object properties: meta: $ref: '#/components/schemas/MetaResponse' data: oneOf: - type: object - type: array ContactByBatchMetaDataResponseDto: type: object properties: id: type: string example: '433445' accountNumberLength: type: number example: 4 chartOfAccount: type: string enum: - SKR03 - SKR04 - SKR42 - SKR51 - SKR14 example: SKR03 createdDate: type: string example: '2025-04-06T00:00:00Z' entries: type: array items: $ref: '#/components/schemas/ContactEntriesResponseDto' fiscalYearStartDate: type: string example: '2025-01-01' taskId: type: string example: ABBDU8834993NND ContactEntriesRequestDto: type: object properties: addresses: type: array items: $ref: '#/components/schemas/ContactAddress' accountNumber: type: number example: 70000 bankAccounts: type: array items: $ref: '#/components/schemas/BankAccount' companyName: type: string example: maesn contactPersons: type: array items: $ref: '#/components/schemas/ContactPersonRequest' example: '[]' contactType: type: string enum: - CONTACT_PERSON - COMPANY example: COMPANY emailAddresses: type: array items: $ref: '#/components/schemas/ContactEmail' number: type: string example: '1042' phoneNumbers: type: array items: $ref: '#/components/schemas/ContactPhone' projectId: type: string example: '3' vatId: type: string example: DE33445672452 MetaResponse: type: object properties: warnings: type: array items: type: string example: Field not used by target system pagination: $ref: '#/components/schemas/PaginationResponse' ContactEntriesResponseDto: type: object properties: addresses: type: array items: $ref: '#/components/schemas/ContactAddress' accountNumber: type: number example: 70000 bankAccounts: type: array items: $ref: '#/components/schemas/BankAccount' companyName: type: string example: maesn contactPersons: type: array items: $ref: '#/components/schemas/ContactPersonRequest' example: '[]' contactType: type: string enum: - CONTACT_PERSON - COMPANY example: COMPANY emailAddresses: type: array items: $ref: '#/components/schemas/ContactEmail' number: type: string example: '1042' phoneNumbers: type: array items: $ref: '#/components/schemas/ContactPhone' projectId: type: string example: '3' vatId: type: string example: DE33445672452 ContactAddress: type: object properties: addressLine1: type: string example: Lucky street 1 addressLine2: type: string example: 2nd floor city: type: string example: Berlin countryCode: type: string enum: - 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 example: DE postalCode: type: string example: '10243' type: type: string enum: - BILLING - DELIVERY - EMPTY - PRIVATE - WORK - PICKUP example: BILLING BankAccount: type: object properties: bic: type: string example: COBADEFFXXX holder: type: string example: John Doe iban: type: string example: DE89370400440532013000 isMainAccount: type: boolean example: true name: type: string example: Sparkasse sepa: type: boolean example: true required: - iban - bic - holder - sepa ContactPersonRequest: type: object properties: emailAddresses: type: array items: $ref: '#/components/schemas/ContactEmail' firstName: type: string example: John lastName: type: string example: Doe phoneNumbers: type: array items: $ref: '#/components/schemas/ContactPhone' salutation: type: string example: Mr ContactEmail: type: object properties: email: type: string example: john.doe@company.com type: type: string enum: - BUSINESS - PRIVATE - OFFICE - INVOICE - PAYMENT - OTHER example: BUSINESS ContactPhone: type: object properties: number: type: string example: +49 7163307056 type: type: string enum: - BUSINESS - MOBILE - FAX - LANDLINE - OFFICE - OTHER - PRIVATE - SKYPE - WHATSAPP example: MOBILE PaginationResponse: type: object properties: total: type: number example: 125 perPage: type: number example: 50 currentPage: type: number example: 1 totalPages: type: number example: 3 ````