Go SDK - Telnyx

The official telnyx-go module provides a Go client generated from the same OpenAPI definition as the API reference.

Requests, types, and pagination

Request fields and unions, response models, options, uploads, and pagination.

Resource map

Search every SDK resource and method and open the matching REST endpoint.

Errors, retries, and timeouts

Handle structured errors and configure retry and timeout behavior.

Webhooks

Verify ED25519 signatures and process webhook events.

Advanced usage

Configure language-specific logging, transport, raw responses, and custom requests.

Install

go get github.com/team-telnyx/telnyx-go/v4

Requirements

This library requires Go 1.22+.

Initialize the client and make a request

Quickstart from the current SDK source, using TELNYX_API_KEY for authentication:

Usage

The full API of this library can be found in api.md.

package main

import (
	"context"
	"fmt"

	"github.com/team-telnyx/telnyx-go/v4"
	"github.com/team-telnyx/telnyx-go/v4/option"
)

func main() {
	client := telnyx.NewClient(
		option.WithAPIKey("My API Key"), // defaults to os.LookupEnv("TELNYX_API_KEY")
	)
	response, err := client.Calls.Dial(context.TODO(), telnyx.CallDialParams{
		ConnectionID: "conn12345",
		From:         "+15557654321",
		To: telnyx.CallDialParamsToUnion{
			OfString: telnyx.String("+15551234567"),
		},
		WebhookURL: telnyx.String("https://your-webhook.url/events"),
	})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", response.Data)
}

Source and releases

SDK releases can follow REST API changes at different times. Check the package registry for the current version and use the resource map to confirm method availability.

Requests, types, and pagination

Resource map

Errors, retries, and timeouts

Webhooks

Advanced usage

​Install

​Requirements

​Initialize the client and make a request

​Usage

​Source and releases

Install

Requirements

Initialize the client and make a request

Usage

Source and releases