README.md

Vonage Server SDK for Node.js

This is the Node.JS Server SDK for Vonage APIs. To use it you will need a Vonage account. Sign up for free at vonage.com.

For full API documentation refer to developer.vonage.com.

• Installation
• Constructor
• Promises
• Testing
• Examples
• References

Installation

With NPM

npm install @vonage/server-sdk

With Yarn

yarn add @vonage/server-sdk

Constructor

const { Vonage } = require('@vonage/server-sdk');

const vonage = new Vonage(credentials, options);

Where credentials is any option from @vonage/auth, and options is any option from @vonage/server-client

Promises

Most methods that interact with the Vonage API uses Promises. You can either resolve these yourself, or use await to wait for a response.

const resp = await vonage.sms.send({
    to: '15552220000',
    from: '15559992222',
    text: 'This is a test',
});

Testing

Run:

npm run test

Or to continually watch and run tests as you change the code:

npm run test-watch

Examples

See the Vonage Node Quickstarts repo.

References

You can find more information for each product below:

• Accounts
• Applications
• Audit
• Auth
• JWT
• Messages
• Number Insight V2
• Number Insights
• Numbers
• Pricing
• Server Client
• Server SDK
• SMS
• Sub Accounts
• Verify
• Verify V2
• Vetch
• Video
• Voice

Supported APIs

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

API	API Release Status	Supported?
Account API	General Availability	✅
Alerts API	General Availability	✅
Application API	General Availability	✅
Audit API	Beta	✅
Conversation API	General Availability	✅
Dispatch API	Beta	❌
External Accounts API	Beta	❌
Media API	Beta	✅
Messages API	General Availability	✅
Meetings API	Deprecated	✅
Number Insight V2 API	Beta	✅
Number Insights API	General Availability	✅
Number Management API	General Availability	✅
Pricing API	General Availability	✅
Proactive Connect API	Deprecated	✅
Redact API	Developer Preview	✅
Reports API	Beta	✅
SMS API	General Availability	✅
Sub Accounts	Beta	✅
Users	General Availability	✅
Verify API	General Availability	✅
Verify v2 API	General Availability	✅
Video API	General Availability	✅
Voice API	General Availability	✅

Network APIS

The following Network APIs are supported however they are opt-in.

API	Supported?
Number Verification	✅
SIM Swap	✅

Network API references

• Number Verification
• SIM Swap

V2 Migrations

While most of the V2 functions have been ported into their own package, some of the functions have not been ported or were removed. Below is a list of those changes:

V2 Function	Status	Note
vonage.conversion	REMOVED
vonage.conversation	Moved	Moved To Conversations
vonage.app	Moved	Moved to Applications
vonage.files	Moved	Move to ServerClient
vonage.message	Moved	Moved to SMS
vonage.generateJwt	Moved	Was moved to JWT
vonage.generateSignature	Moved	Was moved to SMS and Voice
vonage.calls	Moved	Was moved to Voice
vonage.credentials	Updated	Options can be found in Server Client
vonage.options	Updated	Options can be found in Server Client
vonage.options.httpClient	Removed
vonage.options.userAgent	Moved	Options can be found in Server Client

For more information, check out each packages migration guide.