v1

latestOpenAPI 3.1.02026-08-04103211436.0 KB

Contacts

Create contacts in bulk

Creates several contacts in a single call, following the same rules as the single contact creation endpoint: a customId that already exists updates the existing contact rather than creating a duplicate. Contacts sharing the same customId within the request are deduplicated and only the first occurrence is processed.

post/contacts/{companyId}/bulk

Path parameters

companyIdstring required

Request body

Example request

{
  "data": [
    {
      "tradeName": "Acme Supplies",
      "legalName": "Acme Supplies S.L.",
      "taxId": "B12345678",
      "contact": {
        "phone": "+34600000000",
        "email": "billing@acme-supplies.com",
        "name": "John",
        "surname": "Doe"
      },
      "address": {
        "postalCode": "28001",
        "address": "Calle Mayor 10, 3B",
        "province": "Madrid",
        "city": "Madrid",
        "country": "Spain"
      },
      "accounts": [
        {
          "swift": "BBVAESMMXXX",
          "iban": "ES9121000418450200051332"
        }
      ],
      "paymentsAccounts": [
        {
          "details": {
            "iban": "ES9121000418450200051332",
            "bic": "BBVAESMMXXX",
            "swift": "BBVAESMMXXX",
            "accountNumber": "123456789",
            "routingNumber": "021000021",
            "sortCode": "040004",
            "institutionNumber": "001",
            "transitNumber": "12345",
            "bsb": "062-000"
          }
        }
      ],
      "accountingCode": "4300001",
      "paymentMethod": "bank-transaction",
      "paymentTerms": 30,
      "attributes": [
        {
          "customId": "cost-center",
          "value": "Marketing",
          "valueCustomId": "marketing"
        }
      ],
      "customId": "erp-contact-001"
    }
  ]
}

Response

Successful Response