Phone Unsubscribe Webhook

POST

Triggered when a phone number unsubscribes by form submit

Authorizations

• token

Request Body ^required

object

id

Unique entity UUID

string

/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/

api_version

Version of the notification webhook data structure

string

Example

2022-05-25

name

Webhook’s event name

string

created_at

Timestamp when the entity was added to the system by the user

integer

attempt_total

Total number of notification webhook delivery attempts

integer

>= 1 <= 4

Example

4

attempt_number

Current webhook notification attempt number

integer

>= 1

Example

1

data

Event-specific data payload

object

notification_task_id

Notification task identifier (request identifier)

string format: uuid

Example

3378de83-de66-4de8-9d29-2b10d41bb641

name

Allowed values: phone.unsubscribe

data

object

phone

required

Phone number that unsubscribed

string

Example

+436766304011

user_id

required

ID of the user associated with the phone number

integer

Example

2

created_at

required

Unix timestamp when the unsubscribe occurred

integer

Example

1757849748

campaign_code

required

Campaign code associated with the unsubscribe

string

Example

3KCKb5nMD

additional_data

required

object

reason

required

object

id

required

Reason ID for unsubscribe. Possible values:

• 1: I never subscribed
• 2: Too many messages
• 3: I am not interested
• 4: Content is incomprehensible
• 5: I don’t like your company
• 6: Other

integer

Allowed values: 1 2 3 4 5 6

Example

4

label

required

Human-readable reason for unsubscribe

string

Example

Content is incomprehensible

additional_text

required

Additional text provided by the user

string

Example

Additional text from user input

short_link_code

required

Short link code associated with the unsubscribe

string

Example

baaIou

unsubscribe_request_id

required

ID of the unsubscribe request

integer

Example

59

group_id

ID of the group associated with the phone unsubscribe

integer

Example

123

Examples

Phone unsubscribe event

{
  "id": "ef58b437-1319-4b0c-961b-17214cf1cf32",
  "data": {
    "phone": "+4911113333444",
    "user_id": 2,
    "created_at": 1757849748,
    "campaign_code": "3KCKb5nMD",
    "additional_data": {
      "reason": {
        "id": 4,
        "label": "Es ist unverständlich"
      },
      "additional_text": "zusätzlicher Benutzertext mit Erklärung"
    },
    "short_link_code": "baaIou",
    "unsubscribe_request_id": 59
  },
  "name": "phone.unsubscribe",
  "created_at": 1757849748,
  "api_version": "2022-05-25",
  "attempt_number": 1,
  "attempts_total": 4
}

Responses

200

Webhook received

400

Invalid webhook request’s body structure

401

Webhook request unauthorized

403

Webhook access forbidden

404

Webhook access forbidden

500

Server error