DailyStory Webhooks

A webhook is a URL that DailyStory will send an HTTP POST with related data to when events occur within DailyStory. Using a webhook enables your application to receive notifications for events.

Manage Webhooks

To manage webhooks navigate to Account Settings > Webhooks:

Test a Webhook

In the manage webhooks screen you can also test your webhook.

Manage Webhooks using REST API

Subscribe and unsubscribe to webhooks using the Subscription API.

Supported Events

Below are the webhook events supported by DailyStory:

New Contact

Returns the full serialized contact (see ).

New Lead

When a new lead is created.

{
  "id":[numeric id of the lead],
  "dsid":"[unique id of the contact]"
}

Lead Status Changed

When the status of a lead is changed.

{
  "id":[numeric id of the lead],
  "dsid":"[unique id of the contact]",
  "status":"[status changed to, e.g. Deleted ]"
}

Contact Status Changed

When the status of a contact is changed.

{
  "dsid":"[unique id of the contact]",
  "status":"[status changed to, e.g. Deleted ]"
}

URL Shortener Clicked

When a URL Shortener is clicked.

{
  "id":"unique id of the link"
}

Text Message Reply Received

When a contact replies to a text message.

{
  "dsid":"[unique id of the contact]",
  "mobile":"[mobile number that replied]",
  "message":"[received reply]"
}

Email Address Bounced

When an email address used to send an email bounces

{
  "dsid":"[unique id of the contact]",
  "email":"[email address that bounced]",
  "date":"[date/time when email bounced]",
  "messageid":"[unique email message id of the email that bounced]",
  "is_spam_complaint":"[bool indicating if the bounce is due to a spam complaint]",
  "reason":"Permanent Delivery Failure - Address not deliverable"
}

The comment of the response will contain additional details for the reason the email address bounced. If a recipient marks the email as SPAM (complaint) this will also trigger this webhook.

Opted out of Email

When a contact opts out of email.

{
  "dsid":"[unique id of the contact]",
  "email":"[email address that opted out]"
}

Opted out of Text Messaging

When a contact opts out of text messaging.

{
  "dsid":"[unique id of the contact]",
  "mobile":"[mobile number that opted out]"
}

Opted in to Email

When a contact opts in to email.

{
  "dsid":"[unique id of the contact]",
  "email":"[email address that opted in]"
}

Opted in to Text Messaging

When a contact opts in to text messaging.

{
  "dsid":"[unique id of the contact]",
  "mobile":"[mobile number that opted in]"
}

Web Form Submitted

When a web form is submitted.

{
  "webform_id":"[id of the web form]",
  "webform_name":"[name of the web form]",
  "lead_id":[numeric id of the lead],
  "dsid":"[unique id of the contact]"
}