Create multiple contacts

curl --request POST \
  --url https://web-api.clerk.chat/public/contacts/batch \
  --header 'Content-Type: application/json' \
  --header 'apiKey: <api-key>' \
  --data '
{
  "contacts": [
    {
      "name": "John Doe",
      "email": "[email protected]",
      "phone": "+1234567890",
      "public": false,
      "data": {}
    }
  ]
}
'

{
  "data": [
    {
      "id": "1",
      "teamId": "1",
      "createdByUserId": "1",
      "name": "John Doe",
      "phone": "+1234567890",
      "email": "[email protected]",
      "externalId": "1234",
      "optOut": false,
      "avatarURL": "https://example.com/avatar.jpg",
      "public": false,
      "data": {},
      "attributes": [],
      "created": "2021-01-01T00:00:00.000Z",
      "updated": "2021-01-01T00:00:00.000Z"
    }
  ]
}

POST

public

contacts

batch

Create multiple contacts

curl --request POST \
  --url https://web-api.clerk.chat/public/contacts/batch \
  --header 'Content-Type: application/json' \
  --header 'apiKey: <api-key>' \
  --data '
{
  "contacts": [
    {
      "name": "John Doe",
      "email": "[email protected]",
      "phone": "+1234567890",
      "public": false,
      "data": {}
    }
  ]
}
'

{
  "data": [
    {
      "id": "1",
      "teamId": "1",
      "createdByUserId": "1",
      "name": "John Doe",
      "phone": "+1234567890",
      "email": "[email protected]",
      "externalId": "1234",
      "optOut": false,
      "avatarURL": "https://example.com/avatar.jpg",
      "public": false,
      "data": {},
      "attributes": [],
      "created": "2021-01-01T00:00:00.000Z",
      "updated": "2021-01-01T00:00:00.000Z"
    }
  ]
}

Authorizations

apiKey

string

header

required

Body

application/json

contacts

object[]

required

Show child attributes

contacts.name

string

The name of the contact

Example:

"John Doe"

contacts.email

string

The email address of the contact

Example:

"[email protected]"

contacts.phone

string

The phone number of the contact

Example:

"+1234567890"

contacts.public

boolean

Whether the contact is public

Example:

false

contacts.data

object

Additional metadata for the contact

Example:

{}

Response

The created contacts

data

object[]

required

Show child attributes

data.id

string

required

The ID of the contact

Example:

"1"

data.teamId

string

required

The ID of the team the contact belongs to

Example:

"1"

data.createdByUserId

string

required

The ID of the user who created the contact

Example:

"1"

data.name

string

required

The name of the contact

Example:

"John Doe"

data.phone

string

required

The phone number of the contact

Example:

"+1234567890"

data.email

string

required

The email address of the contact

Example:

"[email protected]"

data.externalId

string

required

The external ID of the contact

Example:

"1234"

data.optOut

boolean

required

Whether the contact has opted out of messages

Example:

false

data.avatarURL

string

required

The URL of the contact avatar

Example:

"https://example.com/avatar.jpg"

data.public

boolean

required

Whether the contact is public

Example:

false

data.data

object

required

Additional metadata for the contact

Example:

{}

data.attributes

object[]

required

The contact attributes

Show child attributes

data.attributes.id

string

required

data.attributes.attributeTypeId

string

required

data.attributes.createdAt

string<date-time>

required

data.attributes.updatedAt

string<date-time>

required

data.attributes.value

object

Example:

[]

data.created

string<date-time>

required

Example:

"2021-01-01T00:00:00.000Z"

data.updated

string<date-time>

required

Example:

"2021-01-01T00:00:00.000Z"

Delete a contact Create and trigger a Campaign

⌘I

Public

Public Admin

Create multiple contacts

Authorizations

Body

Response