Skip to main content
DELETE
Remove tag from contact
Send tagId or the tag name as value in the request body. Rate limit: 30 requests/minute per endpoint and workgroup. Details.

Authorizations

x-api-key
string
header
required

Primary public authentication method. Create keys in Jobin.cloud under Workgroups > Integrations > Custom integration.

Path Parameters

contactId
string
required

Jobin contact identifier.

Pattern: ^[a-fA-F0-9]{24}$

Body

application/json

Tag add/remove input. Provide tagId when using an existing Jobin tag, or value when the automation only knows the human-readable tag label.

tagId
string
required

Existing Jobin tag identifier.

Pattern: ^[a-fA-F0-9]{24}$
value
string

Tag label to create/reuse for add operations, or remove by value for remove operations.

Required string length: 1 - 256
iconName
string

Optional icon name used when creating a new tag by value.

Required string length: 1 - 256
color
string

Optional tag color/style used when creating a new tag by value.

Required string length: 1 - 256

Response

Removed tag ids or values and contact update count.

modifiedCount
integer

Number of contact records changed by the tag update.

tag
object

Minimal contact tag metadata exposed for integration filtering.

removedTagIds
string[]
removedValues
string[]