Vonage Client Library for .NET

This library allows you to integrate features from Vonage's APIs into your application.

Full documentation and guides: vonage.github.io/vonage-dotnet-sdk

It requires a Vonage account first.

• Installation
  • Migration guides
  • Targeted frameworks
• Quick Start
• Supported APIs
• Contributing
• Release
• License

dotnet add package Vonage

• Upcoming v9.0.0.
• Upgrading to v8.0.0.
• Upgrading to v7.0.0.
• Upgrading to v6.0.0.
• Upgrading from OpenTok for Video API.

The SDK targets netstandard2.0 and is compatible with .NET 6, 7, and 8.

using Vonage;
using Vonage.Request;
using Vonage.VerifyV2.StartVerification;
using Vonage.VerifyV2.StartVerification.Sms;

var client = new VonageClient(
    Credentials.FromAppIdAndPrivateKeyPath("YOUR_APP_ID", "private.key"));

var result = await client.VerifyV2Client.StartVerificationAsync(
    StartVerificationRequest.Build()
        .WithBrand("MyApp")
        .WithWorkflow(SmsWorkflow.Parse("447700900000"))
        .Create());

result.Match(
    successOperation: response => Console.WriteLine($"Verification started: {response.RequestId}"),
    failureOperation: failure  => Console.WriteLine($"Error: {failure.GetFailureMessage()}"));

For authentication options, DI registration, configuration reference, and logging, see Getting Started.

The following is a list of Vonage APIs and whether the Vonage .NET SDK provides support for them:

Pick your preferred IDE:

• Visual Studio (Community is fine)
• Visual Studio Code
• Jetbrains Rider

1. Get the latest code either by cloning the repository or downloading a snapshot of the source.
2. Open Vonage.sln
3. Build — NuGet dependencies should be brought down automatically.
4. Run all tests to verify everything's fine.

Pull requests are welcome!

To publish a new version, use the release script:

./release.sh <version> [--dry-run]

For example:

# Preview the release without making changes
./release.sh 8.30.0 --dry-run

# Perform the release
./release.sh 8.30.0

The script will:

1. Update the version in Vonage/Vonage.csproj
2. Commit and create a git tag
3. Generate the changelog using git-cliff
4. Push to remote
5. Create a GitHub release

Pre-release versions are also supported (e.g., 8.30.0-beta).

This library is released under the MIT License.