Create contacts

Request

Creates a batch of up to 1000 contacts as specified by the list of contacts.

The contacts are created asynchronously. A CONTACT_CREATE event will be generated for every successfully created contact.

Security

BearerAuth

Path

project_idstringrequired

The unique ID of the project. You can find this on the Sinch Dashboard.

Bodyapplication/jsonrequired

contactsArray of objects, [ 1 .. 1000 ] items(Contact creation request)required

List of contacts to be created in Conversation API.

curl -i -X POST \
  'https://us.conversationbatch.api.sinch.com/v1/projects/{project_id}/contacts' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "contacts": [
      {
        "channel_identities": [
          {
            "channel": "WHATSAPP",
            "identity": "{{PHONE_NUMBER_1}}"
          }
        ],
        "language": "EN_US"
      },
      {
        "channel_identities": [
          {
            "channel": "RCS",
            "identity": "{{PHONE_NUMBER_2}}"
          }
        ],
        "language": "EN_US"
      },
      {
        "channel_identities": [
          {
            "channel": "RCS",
            "identity": "{{PHONE_NUMBER_3}}"
          }
        ],
        "language": "EN_US"
      }
    ]
  }'

Responses

OK

Response

No content

We'd love to hear from you!