Skip to main content

Tracking User Subscription Changes via Webhooks

Updated over 2 weeks ago

This feature allows your system to receive real-time updates whenever a user subscribes or unsubscribes from communications in InTarget.

The event may originate from:

  • an email campaign (for example, a user clicks Unsubscribe), or

  • an action inside the InTarget CRM (for example, a user was unsubscribed manually).

InTarget sends these updates to your webhook endpoint in JSON format.

Quick Start

  1. Provide a webhook URL (HTTPS recommended) to your InTarget manager.

  2. The endpoint must accept POST requests with Content-Type: application/json.

  3. Return 200 OK within 5 seconds after receiving the event.

Event Payload

{
"event": "unsubscribe",
"channel": "crm",
"type": "Phone",
"value": "380932983280",
"occurredAt": "2025-10-09 09:38:30",
"extra": []
}

Field Reference

Field

Type

Description

event

string

"subscribe" or "unsubscribe". Defines whether the user opted in or out.

channel

string

"campaign" β€” event triggered by a user action in an InTarget campaign (e.g., clicking unsubscribe in an email)."crm" β€” event triggered inside the InTarget CRM (e.g., user manually unsubscribed or re-subscribed by an operator).

type

string

The communication type affected β€” e.g. "Email", "Phone", "Web Push".

value

string

The actual contact value (email address, phone number, push token, etc.).

occurredAt

string

The time of the event in YYYY-MM-DD HH:mm:ss (UTC).

extra

array

Reserved for future fields. Currently always [].

Example Events

{"event":"unsubscribe","channel":"crm","type":"Phone","value":"47568796","occurredAt":"2025-10-09 09:38:30","extra":[]}

{"event":"subscribe","channel":"crm","type":"Web Push","value":"diUGUAnO86wkwZRHxQJ4qP:APA91bGVFchEq_98DBHpr_dsx1NcJaB0HJaHipbktdqPigRACFSentPdln-pbvfqpbdEiWzNsaKhpcYOdc2r1bP6WkNlk0Qf06pdVLLCNd9damBs_hDvL00","occurredAt":"2025-10-09 09:41:57","extra":[]}

{"event":"subscribe","channel":"crm","type":"Email","value":"[email protected]","occurredAt":"2025-10-09 09:42:57","extra":[]}

Did this answer your question?