Aller au contenu principal

Créer des contacts par lot

POST/contacts/batch/new

Créer plusieurs contacts en une seule requête. Le corps de la requête est un tableau d'objets contact. Maximum 200 contacts par requête.

Insertion d'objets personnalisés et d'un élément enfant (premium)​

Ajoutez un bloc customObjects à n'importe quel contact pour créer et associer des éléments d'objet personnalisé — et un élément enfant via linkedCustomObjects — dans la même requête. Nécessite un plan premium ; sur les autres plans le bloc est ignoré silencieusement (le contact est tout de même créé et la réponse est 201, sans erreur). Identifiez chaque objet par alias ou id, et placez les valeurs de champ sous attributes. Appelez avec ?includeCustomObjects=true pour renvoyer les éléments créés dans la réponse. Remplacez les alias (product, order-line) et les clés attributes par les vôtres.

[
  {
    "email": "jane@example.com",
    "firstname": "Jane",
    "customObjects": {
      "data": [
        {
          "alias": "product",
          "data": [
            {
              "name": "Contract A",
              "attributes": { "reference": "ABC-123" },
              "linkedCustomObjects": [
                {
                  "alias": "order-line",
                  "data": [
                    { "name": "Line 1", "attributes": { "sku": "SKU-001", "quantity": 2 } }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  }
]

Request​

Responses​

Contacts créés