Signalgrid Go Client

Updated on October 11, 2026

Send Signalgrid notifications from Go applications
using the official Signalgrid Go client library.

The Signalgrid Go client provides a simple way to send notifications from Go applications without manually handling HTTP requests. It wraps the Signalgrid API and allows you to send notifications using a clean and minimal interface.

Installation

Install the official Signalgrid Go client using go get:

Bash
go get github.com/signalgridco/signalgrid-go

Example

The following example shows how to send a notification using the Go client:

Go
package main import ( "fmt" "log" "github.com/signalgridco/signalgrid-go" ) func main() { client, err := signalgrid.NewClient("YOUR_CLIENT_KEY") if err != nil { log.Fatal(err) } resp, err := client.Send(signalgrid.Message{ Channel: "CHANNEL_TOKEN", Type: "INFO", Title: "Hello from Go", Body: "Sent from a Go app using go get.", Critical: false, }) if err != nil { log.Fatal(err) } fmt.Println(resp) }

Parameters

The signalgrid.Message struct defines the notification:

Field
Description
Channel
Channel token that receives the notification.
Type
Notification type (INFO, WARN, CRIT, SUCCESS).
Title
Notification title.
Body
Notification message.
Critical
Send the notification as a critical alert.

Response

The API returns a response containing request metadata:

JSON
{ "ruuid":"09c2e7c68390458f9927c7564529d3599b906840", "text":"OK", "code":"200", "node":"dp02", "time":"380ms" }

How It Works

The Go client internally sends a request to the Signalgrid API using your client_key. It behaves exactly the same as sending a request manually, but simplifies integration by handling request formatting and response parsing for you.

Related Documentation