Skip to content

Create customer contacts in bulk

Request

Creates multiple customer contacts in a single request. Uses partial-success semantics: each contact is processed independently. Always returns 200 with per-item status codes in the response.

Security
BearerAuth
Bodyapplication/jsonrequired
Array [
first_namestring, <= 1500 characters
Example:"John"
last_namestring, <= 1500 characters
Example:"Doe"
avatar_urlstring, (uri), <= 1500 characters

See RFC 3986 for URI syntax.

Example:"https://avatar.example.com/john"
email_addressesArray of objects, <= 10 items(ContactMethodEntry)

Email entries to add, update, or delete. Maximum 10 per contact. Duplicate email values (case-insensitive) are silently ignored.

phone_numbersArray of objects, <= 10 items(ContactMethodEntry)

Phone entries to add, update, or delete. Maximum 10 per contact. Duplicate phone values are silently ignored.

urlsobject(WebLinks)

Web links keyed by subtype. One entry per subtype. Set a value to an empty string to delete that subtype entry.

socialobject(SocialLinks)

Social profile links keyed by subtype. One entry per subtype. Set a value to an empty string to delete that subtype entry.

locationobject(ContactLocation)

Contact location. At least one field must be non-empty.

custom_fieldsobject(CustomFields)

Custom fields keyed by field name. Values are user-defined and may be any JSON scalar. Present as {} when the contact has none set.

Example:
{ "DOB": "14/08/1999" }
]
curl -i -X POST \
  https://developer.setmore.com/api/v2/customers/bulk \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '[
    {
      "first_name": "John",
      "last_name": "Doe",
      "avatar_url": "https://avatar.example.com/john",
      "email_addresses": [
        {
          "id": "20cb5d9a-54cf-445e-8748-fd47aa765b58",
          "value": "eren.yeager221@gmail.com",
          "primary": true,
          "deleted": false
        }
      ],
      "phone_numbers": [
        {
          "id": "20cb5d9a-54cf-445e-8748-fd47aa765b58",
          "value": "eren.yeager221@gmail.com",
          "primary": true,
          "deleted": false
        }
      ],
      "urls": {
        "web": "https://www.example.com",
        "meeting": "https://meet.example.com/john",
        "scheduling": "https://erenyeager7yl0.staging.setmore.com/eren"
      },
      "social": {
        "facebook": "https://facebook.com/john.doe",
        "twitter": "https://twitter.com/john_doe",
        "youtube": "https://youtube.com/@john_doe",
        "instagram": "https://instagram.com/john_doe",
        "skype": "john.doe.skype",
        "linkedin": "https://linkedin.com/in/john-doe"
      },
      "location": {
        "address": "21 Main Street",
        "city": "Chennai",
        "state": "Tamil Nadu",
        "country": "IN",
        "zip": "600001"
      },
      "custom_fields": {
        "DOB": "14/08/1999"
      }
    }
  ]'

Responses

Bulk operation completed, check individual item statuses.

Bodyapplication/json
dataArray of objects(BulkCreateResultItem)
Response
{ "data": [ { … }, { … } ] }