Once you hit enter, you’ll see a service project scaffold on the left sidebar (a folder tree view) that has been automatically generated. At this point, you may have noticed that there’s a “hello world” Javascript function inside ( __main__.js ). To test your function simply click Run on the bottom right corner:

Clicking “Run,” turns your function into an infinitely scalable API endpoint in just a few seconds! Under the “Results” area you will notice a documentation portal - click it to see your API’s information on Standard Library. You will also see an API endpoint URL, click it and a new tab will open showing your“hello world” message live.

Step 3: Replace the Default “Hello World” Function & Set Your STDLIB_LIBRARY_TOKEN

Now let’s create our SMS service that will text back the elevation and prominence of any mountain peak. First, we will replace the default “hello world” function in the __main__.js . Copy and paste the following code that I have provided you with into the __main__.js file:

Once you paste the code into your __main__.js file, you will notice that your dependency on lib (the require('lib') line) is automatically added, there is no need to run an npm install through your terminal — Code on Standard Library will automatically modify your package.json file and install any npm packages into your service directory.

If you look through the code I provided, you will notice that the definition of lib contains a process.env.STDLIB_LIBRARY_TOKEN environment variable. We have to add the required token to the env.json file to get our service working.

Navigate to the env.json file (click env.json in the tree view on the left), there you will see "dev" and "release" environment’s waiting for you to input your "STDLIB_LIBRARY_TOKEN" .

Right-click between the quotation marks next to “STDLIB_LIBRARY TOKEN” to open up the context menu

Place your cursor in between the quotation marks (see above screen) and either right-click and select Insert Library Token… or use the shortcut ⌘ + K.

Select Library Token to fill in both dev and release environments.

Make sure to save the changes with ‘⌘ + s’ (or hit Save in the bottom right).

Step 4: Claim Your Free SMS MessageBird Number

We are almost there! Next, you will claim your free MessageBird phone number. We will use the MessageBird SMS API to send and receive text messages. Standard Library makes it really easy for you to initialize a number, send and receive messages.

Keep Code on Standard Library open. In a different tab, navigate to the MessageBird Numbers API on Standard Library and accept the terms of service (the orange bar at the top).

Accept the MessageBird terms of service — it’s the orange notification at the top of the API reference

After you’ve done that, you can claim your first number directly from the browser! Scroll down the page to the available method on the numbers API:

The “available” method in the MessageBird Numbers API

Currently, only Canadian and US numbers are available — choose the appropriate country code based on your location (if you’d like to see a specific region or country added, e-mail us!) Select one of your Standard Library tokens from the dropdown to the right (it should say Unauthenticated) and press the Run Function button to see a list of available numbers.

Copy one phone number from the list, then scroll down a bit farther to the initialize method.

The “initialize” method in the messagebird.numbers API

The initialize method of the API will claim an initial phone number for personal use, and is free. Enter the number you copied above into the number parameter input, pick a token from the dropdown next to run function, and press “Run Function” to claim your number.

Congratulations! You’ve successfully initialized MessageBird on Standard Library! You can test this by sending a text message using the messagebird.sms service. Navigate to the MessageBird SMS API reference and try the create function with your personal phone number as a recipient — you should receive a text message from the number you’ve just claimed!

The “create” method in the messagebird.sms API

Step 5: Testing Your Service from Code on Standard Library

Now that you have claimed your free number, we can test your SMS service.

Return to the __main__.js file located inside your “MyFirstAPI” service. We will be filling in the section requesting parameters located on the right sidebar. MessageBird passes in four parameters to an SMS handler. These are the MessageBird number receiving the message, which will be the number you claimed earlier, the outside number that sent the incoming message, the contents of the message, and the time the message was sent.

sender: Your cell phone number that will receive the text

receiver: The Standard Library phone number that received the SMS

message: The name of the mountain peak you are requesting elevation and prominence info. (e.g. Denali)

createdDatetime: Date when the SMS was sent

Click Run.

Within seconds you will receive an SMS text from your previously claimed MessageBird number.

Pretty neat huh? But we aren’t done yet! Now that your service has been created, we will set it as a handler for the MessageBird telephone number you previously claimed.

Step 6: Set SMS Message Response Handlers with MessageBird and Standard Library

When you set your service as a handler for the number you just claimed with MessageBird handlers API, it will trigger whenever that number receives a text message. We will use the messagebird.handlers.sms.set API method. You can do this directly from the browser! Head on over to https://stdlib.com/@messagebird/lib/handlers/.

Scroll down until you see the two parameters number and identifier

Number: The MessageBird Number you claimed in step 4

Identifier: <YOUR_USERNAME>.MyFirstAPI[@dev]

(Note: <YOUR_USERNAME> is, of course, your username, and “.MyFirstAPI[@dev]” assumes you named your API “MyFirstAPI” in the initial step)

After you input the required parameters click Run Function.

And that is it! To test your service send an SMS message with the name of any mountain to your MessageBird number. You should receive a reply within seconds!

You can customize the handler to run any kind of code you’d like — and text back responses from other APIs. Just install whatever npm packages you need and modify the functions/__main__.js handler with whatever logic you want. Your SMS service is ready to test!

Suggested Step — Clean Up Your Code

The default sample API package (blank) may have some extra endpoints and files that you don’t need (like anything in the functions/ folder aside from your __main__.js endpoint)— you’ll want to clean these up eventually. To remove (and otherwise manage) files, right click on the file or folder you’d like to remove and click Delete.

That’s It, and Thank You!

Thanks for reading! I am excited to see what neat services you come up with to add to Standard Library. You can replicate these steps with any API of your choice to create a cool service like this crypto price checker!

I would love for you to comment here, e-mail me at Janeth [at] stdlib [dot] com, or follow Standard Library on Twitter, @StdLibHQ . Let me know if you’ve built anything exciting that you would like Standard Library team to feature or share — I’d love to help!