Kudosity SMS

Kudosity SMS

Send SMS alerts via Kudosity when PostHog events or metrics cross thresholds. Ideal for operational monitoring, on-call notifications, and business metric tracking.

Configuration

OptionDescription
Kudosity API Key
Type: string
Required: True

Your Kudosity API key from Settings → API Keys. If you don’t have one yet, sign up for a free developer trial at https://kudosity.com/developer-trial. This authenticates all SMS requests to Kudosity's API.

Sender Number or ID
Type: string
Required: True

Your approved sender number or alphanumeric ID. Use E.164 format (e.g. +61412345678) for numbers. Alphanumeric IDs (max 11 characters, e.g. 'MyCompany') are allowed. Must be pre-approved in your Kudosity account.

Recipient Phone Number
Type: string
Required: True

Phone number to receive SMS alerts, in E.164 format (e.g. +61412345678). You can also use PostHog variables like {person.properties.phone} or {event.properties.oncall_number} for dynamic routing.

Message Template
Type: string
Required: True

The text body of your alert message. Use PostHog variables inside curly braces, e.g.: ⚠️ {event.properties.insight_name} is {event.properties.current_value} (threshold: {event.properties.threshold_value}). Messages over 160 characters will be split automatically.

Message Reference
Type: string
Required: False

Optional custom ID for tracking this alert (max 500 chars). You can include variables such as {event.properties.alert_id} to correlate with Kudosity delivery logs.

Track Links
Type: boolean
Required: False

Automatically shorten and track links included in the SMS message. Useful for marketing or engagement analytics.

Debug Mode
Type: boolean
Required: False

Enables detailed logging for delivery and API responses. Turn on for troubleshooting or testing only.

Using our REST API you can create this destination like so:

Terminal
# Create a new destination
curl --location 'https://us.i.posthog.com/api/environments/:project_id/hog_functions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <POSTHOG_PERSONAL_API_KEY>' \
--data '{
"type": "destination",
"name": "Kudosity SMS",
"inputs": {
"api_key": {
"value": ""
},
"sender": {
"value": ""
},
"recipient": {
"value": ""
},
"message": {
"value": ""
}
},
"enabled": true,
"template_id": "template-kudosity-sms"
}'

Community questions

Questions about this page? or post a community question.