Send Push Notifications and Trigger Live Activities with Go

Use the official Go SDK to deliver immediate Push Notifications and Live Activity progress updates for long-running jobs and automation workflows.

REPOSITORY

github.com/ActivitySmithHQ/activitysmith-go

DOCUMENTATION

activitysmith.com/docs/sdks/go

Install

go get github.com/ActivitySmithHQ/activitysmith-go

Push Notifications

Send an immediate notification for a completed task or event:

Push notification example for a new subscription event
package main
import (
	activitysmithsdk "github.com/ActivitySmithHQ/activitysmith-go"
)
func main() {
  apiKey := os.Getenv("ACTIVITYSMITH_API_KEY")
  client, err := activitysmithsdk.New(apiKey)
  params := activitysmithsdk.PushNotificationInput{
	Title:   "New subscription 💸",
	Message: "Customer upgraded to Pro plan",
  }
  client.Notifications.Send(params)
}

Rich Push Notifications with Media

Send images, videos, or audio with your push notifications, press and hold to preview media directly from the notification, then tap through to open the linked content.

Image Preview

Rich push notification with image
_, err = client.Notifications.Send(activitysmithsdk.PushNotificationInput{
	Title:       "Homepage ready",
	Message:     "Your agent finished the redesign.",
	Media:       "https://cdn.example.com/output/homepage-v2.png",
	Redirection: "https://github.com/acme/web/pull/482",
})
return err

Audio Preview

Rich push notification with audio

What will work

  • direct image URL: .jpg, .png, .gif, etc.
  • direct audio file URL: .mp3, .m4a, etc.
  • direct video file URL: .mp4, .mov, etc.
  • URL that responds with a proper media Content-Type, even if the path has no extension

Media can be combined with Redirection, but not with Actions.

Actionable Push Notifications

Push notification redirection and actions are optional. Use them to open HTTPS URLs, run a specific iPhone Shortcut with a shortcuts://run-shortcut?name=... URL, or trigger backend webhook workflows.

Actionable push notification with redirection and actions
_, err = client.Notifications.Send(activitysmithsdk.PushNotificationInput{
	Title:       "New subscription 💸",
	Message:     "Customer upgraded to Pro plan",
	Redirection: "https://crm.example.com/customers/cus_9f3a1d",
	Actions: []activitysmithsdk.PushNotificationAction{
		activitysmithsdk.PushAction(
			"Open CRM Profile",
			"open_url",
			"https://crm.example.com/customers/cus_9f3a1d",
		),
		activitysmithsdk.PushAction(
			"Chat with Jarvis",
			"open_url",
			"shortcuts://run-shortcut?name=Jarvis",
		),
		activitysmithsdk.PushAction(
			"Start Onboarding Workflow",
			"webhook",
			"https://hooks.example.com/activitysmith/onboarding/start",
			activitysmithsdk.PushActionMethod("POST"),
			activitysmithsdk.PushActionBody(map[string]interface{}{
				"customer_id": "cus_9f3a1d",
				"plan":        "pro",
			}),
		),
	},
})
return err

Live Activities

Choose the Live Activity type that matches what you want to show:

Stats Live Activity with six labeled sales metrics

Stats

Show up to 8 labeled values on your Lock Screen, from revenue and orders to uptime and conversion.

Metrics Live Activity with CPU and memory values

Metrics

Track two related values with segmented bars, such as CPU and memory.

Segmented Progress Live Activity showing a workflow step

Segmented Progress

Show progress through a known set of steps, like build, test, deploy, and verify.

Progress Live Activity showing percentage completion

Progress

Show percentage progress for jobs that move continuously toward completion.

Alert Live Activity showing a customer reactivation update

Alert

Show status updates with a clear message, badge, and icon. When you add an action button, color controls the button tint.

Timer Live Activity showing a benchmark run countdown

Timer

Count down from a duration, or count up from 00:00 while a job runs.

Start & Update Live Activity

Use a stable streamKey to identify the metric, job, deployment, or system you want to keep visible. The first Stream(...) call starts the Live Activity. Later calls with the same streamKey update it.

Stats stream example
activitysmith.LiveActivities.Stream(
	"sales-hourly",
	activitysmithsdk.LiveActivityStreamInput{
		Title:    "Sales",
		Subtitle: "last hour",
		Type:     "stats",
		Metrics: []activitysmithsdk.ActivityMetric{
			activitysmithsdk.Metric("Revenue", "$2430", activitysmithsdk.MetricColor("blue")),
			activitysmithsdk.Metric("Orders", "37", activitysmithsdk.MetricColor("green")),
			activitysmithsdk.Metric("Conversion", "4.8%", activitysmithsdk.MetricColor("magenta")),
			activitysmithsdk.Metric("Avg Order", "$65.68", activitysmithsdk.MetricColor("yellow")),
			activitysmithsdk.Metric("Refunds", "$84", activitysmithsdk.MetricColor("red")),
			activitysmithsdk.Metric("New Buyers", "18", activitysmithsdk.MetricColor("cyan")),
		},
	},
)
Metrics stream example
activitysmith.LiveActivities.Stream(
	"prod-web-1",
	activitysmithsdk.LiveActivityStreamInput{
		Title:    "Server Health",
		Subtitle: "prod-web-1",
		Type:     "metrics",
		Metrics: []activitysmithsdk.ActivityMetric{
			activitysmithsdk.Metric("CPU", 9, activitysmithsdk.MetricUnit("%")),
			activitysmithsdk.Metric("MEM", 45, activitysmithsdk.MetricUnit("%")),
		},
	},
)
Segmented progress stream example
activitysmith.LiveActivities.Stream(
	"nightly-backup",
	activitysmithsdk.LiveActivityStreamInput{
		Title:         "Nightly Backup",
		Subtitle:      "upload archive",
		Type:          "segmented_progress",
		NumberOfSteps: 3,
		CurrentStep:   2,
	},
)
Progress stream example
activitysmith.LiveActivities.Stream(
	"search-reindex",
	activitysmithsdk.LiveActivityStreamInput{
		Title:      "Search Reindex",
		Subtitle:   "catalog-v2",
		Type:       "progress",
		Percentage: 42,
	},
)
Alert stream example
activitysmith.LiveActivities.Stream(
	"customer-ops",
	activitysmithsdk.LiveActivityStreamInput{
		Title:   "Reactivation",
		Message: "Lumen came back after 2 weeks",
		Type:    activitysmithsdk.LiveActivityTypeAlert,
		Icon:    activitysmithsdk.AlertIcon("cloud.sun", "yellow"),
		Badge:   activitysmithsdk.AlertBadge("Customer", "magenta"),
	},
)

The icon.symbol value is an Apple SF Symbol name. Browse the catalog with one of these tools:

  • ActivitySmith app - Open Settings -> SF Symbols to browse 45 hand-picked icons ready to use
  • SF Symbols - Apple's official macOS app
  • Interactful - free third-party iOS app listing all SF Symbols under Foundations -> Iconography
Timer Live Activity showing a benchmark run countdown
activitysmith.LiveActivities.Stream(
	"benchmark-run",
	activitysmithsdk.LiveActivityStreamInput{
		Title:           "Benchmark Run",
		Subtitle:        "sampling",
		Type:            "timer",
		DurationSeconds: 300,
		Color:           "cyan",
	},
)

For a countdown, send duration_seconds. You can update title, subtitle, color, or any other visible field as the work changes. Leave duration_seconds out unless you want to change the timer.

To start at 00:00 and count up, set counts_down: false and leave out duration_seconds.

End Live Activity

Call EndStream(...) with the same streamKey to dismiss the Live Activity. You can include final values before it is removed. By default, iOS removes the Live Activity after two minutes. Set AutoDismissMinutes to choose a different dismissal time, including 0 for immediate dismissal.

activitysmith.LiveActivities.EndStream(
	"prod-web-1",
	activitysmithsdk.LiveActivityStreamEndInput{
		Title:    "Server Health",
		Subtitle: "prod-web-1",
		Type:     "metrics",
		Metrics: []activitysmithsdk.ActivityMetric{
			activitysmithsdk.Metric("CPU", 7, activitysmithsdk.MetricUnit("%")),
			activitysmithsdk.Metric("MEM", 38, activitysmithsdk.MetricUnit("%")),
		},
		AutoDismissMinutes: 2,
	},
)

Live Activity Action

Live Activities can include one optional action button.

  • open_url: open an HTTPS URL.
  • open_url with a shortcuts:// URL: run an Apple Shortcut, for example to open an app.
  • webhook: trigger a backend GET/POST workflow.

Open URL action

Metrics Live Activity with action
activitysmith.LiveActivities.Stream(
	"prod-web-1",
	activitysmithsdk.LiveActivityStreamInput{
		Title:    "Server Health",
		Subtitle: "prod-web-1",
		Type:     "metrics",
		Metrics: []activitysmithsdk.ActivityMetric{
			activitysmithsdk.Metric("CPU", 76, activitysmithsdk.MetricUnit("%")),
			activitysmithsdk.Metric("MEM", 52, activitysmithsdk.MetricUnit("%")),
		},
		Action: &activitysmithsdk.LiveActivityActionInput{
			Title: "Dashboard",
			Type:  "open_url",
			URL:   "https://ops.example.com/servers/prod-web-1",
		},
	},
)

Apple Shortcut action

activitysmith.LiveActivities.Stream(
	"deploy-payments-api",
	activitysmithsdk.LiveActivityStreamInput{
		Title:         "Deploying payments-api",
		Subtitle:      "Running database migrations",
		Type:          "segmented_progress",
		NumberOfSteps: 5,
		CurrentStep:   3,
		Action: &activitysmithsdk.LiveActivityActionInput{
			Title: "Chat with Jarvis",
			Type:  "open_url",
			URL:   "shortcuts://run-shortcut?name=Jarvis",
		},
	},
)

Webhook action

activitysmith.LiveActivities.Stream(
	"search-reindex",
	activitysmithsdk.LiveActivityStreamInput{
		Title:         "Reindexing product search",
		Subtitle:      "Shard 7 of 12",
		Type:          "segmented_progress",
		NumberOfSteps: 12,
		CurrentStep:   7,
		Action: &activitysmithsdk.LiveActivityActionInput{
			Title:  "Pause Reindex",
			Type:   "webhook",
			URL:    "https://ops.example.com/hooks/search/reindex/pause",
			Method: "POST",
			Body: map[string]interface{}{
				"job_id":       "reindex-2026-03-19",
				"requested_by": "activitysmith-go",
			},
		},
	},
)

Icons and Badges

Add more context to Live Activities with icons and badges.

Icon

Supported Live Activity types: stats, metrics, progress, segmented_progress, and alert.

Metrics Live Activity with an SF Symbol icon on the iPhone Lock Screen
activitysmith.LiveActivities.Stream(
	"prod-web-1",
	activitysmithsdk.LiveActivityStreamInput{
		Title:    "Server Health",
		Subtitle: "prod-web-1",
		Type:     "metrics",
		Icon:     activitysmithsdk.AlertIcon("server.rack", "blue"),
		Metrics: []activitysmithsdk.ActivityMetric{
			activitysmithsdk.Metric("CPU", 18, activitysmithsdk.MetricUnit("%")),
			activitysmithsdk.Metric("MEM", 42, activitysmithsdk.MetricUnit("%")),
		},
	},
)

The icon.symbol value is an Apple SF Symbol name. Browse the catalog with one of these tools:

  • ActivitySmith app - Open Settings -> SF Symbols to browse 45 hand-picked icons ready to use
  • SF Symbols - Apple's official macOS app
  • Interactful - free third-party iOS app listing all SF Symbols under Foundations -> Iconography

Badge

Badges are supported by alert, progress, and segmented_progress Live Activities.

Progress Live Activity with a badge on the iPhone Lock Screen
activitysmith.LiveActivities.Stream(
	"nightly-database-backup",
	activitysmithsdk.LiveActivityStreamInput{
		Title:      "Nightly Database Backup",
		Subtitle:   "verify restore",
		Type:       "progress",
		Badge:      activitysmithsdk.AlertBadge("S3", "cyan"),
		Percentage: 62,
	},
)

Live Activity Colors

Choose from these colors for the Live Activity accent, including progress bars and action buttons, or apply them to an individual icon or badge:

lime
green
cyan
blue
purple
magenta
red
orange
yellow
gray

Widgets

Lock screen widgets

ActivitySmith lets you display any value on your Lock Screen with widgets - SaaS metrics, revenue, number of users, uptime, or anything else you want to track. Create a metric in the web app, then update the metric value using our API, add a widget to your lock screen and it will fetch the latest update automatically.

Create widget metric
activitysmith.Metrics.Update("deploy.success_rate", 99.9)

String metric values work too.

activitysmith.Metrics.Update("prod.status", "healthy")

Integrate with any Go application

Keep your team aligned with immediate event delivery across incidents, business signals, and automation outcomes.

Start TodayBook a Demo

Explore other SDKs

Node.js SDK

Live
Open SDK →

Python SDK

Live
Open SDK →

PHP SDK

Live
Open SDK →

Ruby SDK

Live
Open SDK →

Explore Integrations

Connect ActivitySmith to automation and delivery platforms, then route runtime events to Push Notifications and Live Activities on your iOS devices.

Zapier logo

Zapier

By ActivitySmith

Live
Open integration ->

GitHub Action

By ActivitySmith

Live
Open integration ->

GitHub Webhooks

By ActivitySmith

Live
Open integration ->
GitLab logo

GitLab

By ActivitySmith

Live
Open integration ->
Vercel logo

Vercel

By ActivitySmith

Live
Open integration ->
Railway logo

Railway

By ActivitySmith

Live
Open integration ->
Netlify logo

Netlify

By ActivitySmith

Live
Open integration ->
ActivitySmith app icon

MCP Server

By ActivitySmith

Live
Open integration ->
ActivitySmith skill logo

ActivitySmith Skill

By ActivitySmith

Live
Open integration ->
Sentry logo

Sentry

By ActivitySmith

Live
Open integration ->
Linear logo

Linear

By ActivitySmith

Live
Open integration ->
n8n logo

n8n

By ActivitySmith

Live
Open integration ->
CircleCI logo

CircleCI

By ActivitySmith

Live
Open integration ->
Stripe logo

Stripe

By ActivitySmith

Coming Soon
Coming soon
Polar logo

Polar

By ActivitySmith

Coming Soon
Coming soon

Render

By ActivitySmith

Coming Soon
Coming soon

Fly.io

By ActivitySmith

Coming Soon
Coming soon

Travis CI

By ActivitySmith

Coming Soon
Coming soon

Coolify

By ActivitySmith

Coming Soon
Coming soon