Send an SMS Message with .NET Core

Learn how to quickly send SMS messages in a .Net Core application with the Sinch API.

Set up your .Net Core application

1. Create a new folder where you want your app project. Then, open a terminal or command prompt to that location.
2. Create a new .Net Core console app with the following command:
   Copy

   Copied

   dotnet new console

3. Add the Newtonsoft.Json nuget package.
   Copy

   Copied

   dotnet add package Newtonsoft.Json

Modify your application

1. Open the Program.cs file in your project folder. Replace everything in the file with the following code:
   Copy

   Copied

   SMS sms = new SMS("YOUR_Sinch_virtual_number", new string[] {"recipient_number"}, "Hello from Sinch!" );
   sms.sendSMS(sms, "YOUR_servicePlanId", "YOUR_API_token");
   Console.ReadLine();

2. Next, create a new file in the project folder named SMS.cs. Populate that file with the "Send an SMS message" code found on this page.
3. Save the file.

Fill in your parameters

1. Back in the Program.cs file, replace the following values for these parameters with your values:

   Parameter	Your value
   YOUR_Sinch_virtual_number	Any number you've assigned to your Sinch account. Find the number on your Sinch dashboard by clicking the service plan ID link and scrolling to the bottom of the page.
   recipient_number	The phone number to which you want to send the test SMS message.
   YOUR_servicePlanId	The API token found on your Sinch dashboard. Click Show to reveal your API token.
   YOUR_API_token	The service plan ID found on your Sinch dashboard.

   Double check that the region is correct on your base URL. Learn more about regional options here.

2. Save the file.

Build your project

Before executing your code, you must first compile your application. Execute the following command:

dotnet build

Send your first SMS message

Now you can execute the code and send your test SMS message. Run the following command:

dotnet run

Next steps

• Learn how to recieve SMS

Additional resources

• Explore the API specification to test more endpoints.