Contacts

Get Contact

get

Get a contact by phone number or email

Authorizations

ApiKeyAuth

apiKeystringRequired

Query parameters

apiKeystringOptional

API key for authentication

Example: your_api_key

phoneNumberstringOptional

Contact's phone number (must include valid country code)

Example: [phone]

emailstring · emailOptional

Contact's email address

Example: [email protected]

Responses

200

Contact found

application/json

400

Invalid request

application/json

401

Unauthorized

application/json

404

Contact not found

application/json

500

Server error

application/json

get

/contacts

HTTPcURLJavaScriptPython

GET /v1/contacts HTTP/1.1
Host: api.dmchamp.com
Accept: */*

{
  "success": true,
  "contactId": "abc123"
}

Create New Contact

post

Create a new contact with phone number and optional information

Authorizations

ApiKeyAuth

apiKeystringRequired

Query parameters

apiKeystringOptional

API key for authentication

Example: your_api_key

Body

application/json

phoneNumberstringRequired

Contact's phone number (must include valid country code)

firstNamestringOptional

Contact's first name

Default: Unknown

lastNamestringOptional

Contact's last name

Default: Unknown

emailstring · emailOptional

Contact's email address

Default: [email protected]

instagramIdstring | nullableOptional

Contact's Instagram ID

currentCampaignstring | nullableOptional

Current campaign identifier

currentCampaignDataobject | nullableOptional

Data associated with current campaign

channelstring | nullableOptional

Communication channel

isChatWindowOpenbooleanOptional

Whether chat window is open

Default: false

externalIdstring | nullableOptional

External identifier

customChannelstring | nullableOptional

Custom channel identifier

chatWidgetIdstring | nullableOptional

Chat widget identifier

is_bot_activebooleanOptional

Whether the bot is active for this contact

Default: true

do_not_disturbbooleanOptional

Whether the contact should not be disturbed

Default: false

Responses

200

Contact created successfully

application/json

400

Invalid request

application/json

401

Unauthorized

application/json

409

Contact already exists

application/json

post

/contacts

HTTPcURLJavaScriptPython

POST /v1/contacts HTTP/1.1
Host: api.dmchamp.com
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "phoneNumber": "[phone]",
  "firstName": "John",
  "lastName": "Doe",
  "email": "[email protected]",
  "is_bot_active": true,
  "do_not_disturb": false
}

{
  "success": true,
  "data": {
    "message": "Successfully created new contact",
    "contactId": "abc123"
  }
}

Update Contact

put

Update an existing contact's information

Authorizations

ApiKeyAuth

apiKeystringRequired

Path parameters

contactIdstringRequired

ID of the contact to update

Query parameters

apiKeystringOptional

API key for authentication

Example: your_api_key

Body

application/json

firstNamestringOptional

Contact's first name

lastNamestringOptional

Contact's last name

emailstring · emailOptional

Contact's email address

is_bot_activebooleanOptional

Whether the bot is active for this contact

do_not_disturbbooleanOptional

Whether the contact should not be disturbed

Responses

200

Contact updated successfully

application/json

400

Invalid request

application/json

401

Unauthorized

application/json

404

Contact not found

application/json

500

Server error

application/json

put

/contacts/{contactId}

HTTPcURLJavaScriptPython

PUT /v1/contacts/{contactId} HTTP/1.1
Host: api.dmchamp.com
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "[email protected]",
  "is_bot_active": false,
  "do_not_disturb": true
}

{
  "success": true,
  "message": "Contact updated successfully"
}

Add Contact To List

post

Add a specific contact to a list

Authorizations

ApiKeyAuth

apiKeystringRequired

Query parameters

apiKeystringOptional

API key for authentication

Example: your_api_key

Body

application/json

contactIdstringRequired

ID of the contact to add to the list

listIdstringRequired

ID of the list to add the contact to

Responses

200

Contact added to list successfully

application/json

400

Missing required parameters

application/json

401

Unauthorized

application/json

403

Permission denied

application/json

500

Server error

application/json

post

/contacts/lists

HTTPcURLJavaScriptPython

POST /v1/contacts/lists HTTP/1.1
Host: api.dmchamp.com
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "contactId": "contact123",
  "listId": "list456"
}

{
  "success": true,
  "message": "Contact successfully added to list My List"
}

Remove Contact From List

delete

Remove a specific contact from a list

Authorizations

ApiKeyAuth

apiKeystringRequired

Query parameters

apiKeystringOptional

API key for authentication

Example: your_api_key

Body

application/json

contactIdstringRequired

ID of the contact to remove from the list

listIdstringRequired

ID of the list to remove the contact from

Responses

200

Contact removed from list successfully

application/json

400

Missing required parameters

application/json

401

Unauthorized

application/json

403

Permission denied

application/json

500

Server error

application/json

delete

/contacts/lists

HTTPcURLJavaScriptPython

DELETE /v1/contacts/lists HTTP/1.1
Host: api.dmchamp.com
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "contactId": "contact123",
  "listId": "list456"
}

{
  "success": true,
  "message": "Contact successfully removed from list My List"
}

Get Contact Tags

get

Get all tags associated with a contact

Authorizations

ApiKeyAuth

apiKeystringRequired

Path parameters

contactIdstringRequired

ID of the contact to get tags for

Query parameters

apiKeystringOptional

API key for authentication

Example: your_api_key

Responses

200

List of contact tags

application/json

400

Missing contact ID

application/json

401

Unauthorized

application/json

404

Contact not found

application/json

get

/contacts/tags/{contactId}

HTTPcURLJavaScriptPython

GET /v1/contacts/tags/{contactId} HTTP/1.1
Host: api.dmchamp.com
Accept: */*

[
  {
    "name": "text",
    "description": "text"
  }
]

Get Contact Messages

get

Retrieve messages for a specific contact

Authorizations

ApiKeyAuth

apiKeystringRequired

Path parameters

contactIdstringRequired

ID of the contact to get messages for

Query parameters

apiKeystringOptional

API key for authentication

Example: your_api_key

Responses

200

List of messages

application/json

400

Missing contact ID

application/json

401

Unauthorized

application/json

404

Contact not found

application/json

get

/contacts/messages/{contactId}

HTTPcURLJavaScriptPython

GET /v1/contacts/messages/{contactId} HTTP/1.1
Host: api.dmchamp.com
Accept: */*

{
  "success": true,
  "data": [
    {
      "content": "text",
      "timestamp": "2026-01-17T21:15:07.509Z",
      "sender": "text",
      "channel": "text"
    }
  ]
}