Skip to main content
DELETE
Remove tags from a contact

Authorizations

Authorization
string
header
required

HTTP Basic Authentication. Use your API Access Key ID as the username and your API Access Key Secret as the password. Generate keys in the CloudTalk Dashboard under Account -> Settings -> API Keys (https://dashboard.cloudtalk.io/menu/account/settings/API-keys).

Path Parameters

contactId
string
required

The contact id.

Example:

"44210"

Query Parameters

tagIds
string
required

1 to 50 comma-separated contact tag ids.

Example:

"123,131"

Response

The contact, with its tags after the change.

A contact or lead, with every number, email, tag and custom field.

id
string
required

Contact id.

Example:

"44210"

type
enum<string>
required
Available options:
contact,
lead
name
string | null
required

The contact's name. null only for an older contact saved without one: contacts created through this API always have a name, and an update cannot clear it.

Required string length: 1 - 150
Example:

"Jane Doe"

title
string | null
required
Maximum string length: 255
company
string | null
required
Maximum string length: 100
industry
string | null
required
Maximum string length: 100
website
string | null
required
Maximum string length: 100
address
string | null
required
Maximum string length: 255
city
string | null
required
Maximum string length: 255
state
string | null
required
Maximum string length: 255
zip
string | null
required
Maximum string length: 15
country
object | null
required
phones
string[]
required

Every number on the contact, in E.164.

Example:
emails
string[]
required

Every email on the contact.

Example:
tags
object[]
required

The contact's contact tags. Integration tags are not listed.

customFields
object
required

Custom field values as strings, keyed by the field name from List contact fields.

Example:
favoriteUserId
string | null
required

The user who owns the contact.

Example:

"7"

source
string
required

Where the contact came from. Contacts created through this API have api. Read-only.

Example:

"api"

createdAt
string<date-time>
required
updatedAt
string<date-time>
required

Time of the last change. It moves on changes made through this API, the Dashboard contact form and CSV import. Dashboard bulk edits, CRM list sync, and renaming or deleting a contact tag do not move it.

dashboardUrl
string
required

Link to the contact's page in the CloudTalk Dashboard. It carries no credentials: the person must be signed in to your company's Dashboard, and your company must have Contacts in its menu, otherwise the Dashboard opens their default page. Read-only.

Example:

"https://dashboard.cloudtalk.io/menu/contacts/details/44210"