Skip to content
API PlatformDevelopers

Webhook events · conversations

conversation.tag.removed/1

Conversation tag removed. A tag was removed from a conversation.

Payload

We POST this JSON to your endpoint. Answer any 2xx within 30 seconds. The same id arrives again on a retry — skip ones you have handled.

Payload fields
FieldTypeWhat it is
idrequiredstringEvent id. The same on every retry: use it to skip duplicates.pattern ^evt_[0-9A-HJKMNP-TV-Z]{26}$
typerequiredstringEvent type.always conversation.tag.removed
versionrequiredstringPayload version.always 1
api_versionrequiredstringThe endpoint's API version.
occurred_atrequiredstringWhen it happened.date-time
company_idrequiredintegerYour workspace id.
datarequiredobject
conversationrequiredobject
idrequiredintegerConversation id.
company_idrequiredintegerWorkspace id.
contactobject or nullThe contact.
idrequiredintegerId.
namerequiredstring or nullName.
tagrequiredobject
idrequiredintegerTag id.
namerequiredstringName.
slugstring or nullSlug.

Example

{
  "id": "evt_01J8Z7BZQ4F6G8J2K5N7Q9S1VC",
  "type": "conversation.tag.removed",
  "version": "1",
  "api_version": "2026-10-01",
  "occurred_at": "2026-09-24T09:20:00Z",
  "company_id": 1001,
  "data": {
    "conversation": {
      "id": 77410,
      "company_id": 1001
    },
    "contact": {
      "id": 48213,
      "name": "Jane Doe"
    },
    "tag": {
      "id": 4,
      "name": "new-lead",
      "slug": "new-lead"
    }
  }
}

Headers

  • Webhook-Signature: t=…,v1=… — how to check it
  • Webhook-Id (also Webhook-Event-Id): the event id, the same on every retry — skip ones you have handled
  • Webhook-Delivery-Id: this delivery attempt, new on every try