Unsubscribe Webhook

Talkable Unsubscribe Webhook provides notification of a user unsubscribing from Talkable sent referral email.

Use cases for the Unsubscribe Webhook include:

• Unsubscribing users from in-house marketing newsletters when user unsubscribes from Talkable referral emails

• Any event that should be triggered when a user unsubscribes from Talkable referral emails

When does Talkable call the Unsubscribe Webhook?

Talkable Unsubscribe Webhook is called any time a user unsubscribes from a Talkable sent email.

Payload parameters provided

• person — subhash of parameters describing the person

  • email — person’s email address

  • phone_number — person’s phone number

  • first_name — person’s first name

  • last_name — person’s last name

  • username — person’s username (optional)

  • sub_choice — subscription choice (optional, present only if the form included subscription checkbox)

  • subscribed_at — date person has subscribed (deprecated; use opted_in_at instead)

  • opted_in_at — date person has subscribed (optional)

  • unsubscribed_at — date person has unsubscribed (optional)

  • custom_properties — hash of person’s custom properties (optional)

  • referral_counts - subhash of Advocate’s referral counts

    • total — created referrals count

    • approved — approved referrals count

    • pending — count of waiting for approval referrals

Sample payload

{
  "person": {
    "first_name": "Bob",
    "last_name": "Smith",
    "email": "referrer@example.com",
    "username": "username",
    "unsubscribed_at": null,
    "subscribed_at": "2018-09-27T22:55:13.860+03:00",
    "opted_in_at": "2018-09-27T22:55:13.860+03:00",
    "sub_choice": true,
    "referral_counts": {
      "total": 0,
      "approved": 0,
      "pending": 0
    },
    "is_loyalty_member": false,
    "loyalty_member": null
  }
}

cURL example

curl --data 'key=<key>&site=<site>&type=unsubscribe_web_hook&payload={"person":{"first_name":"Bob","last_name":"Smith","email":"referrer@example.com","username":"username","unsubscribed_at":null,"subscribed_at":"2018-09-27T22:55:13.860+03:00","opted_in_at":"2018-09-27T22:55:13.860+03:00","sub_choice":true,"referral_counts":{"total":0,"approved":0,"pending":0}}}' <url>