The Developer Hub

Welcome to the Apperyio developer hub. You'll find comprehensive guides and documentation to help you start working with apperyio as quickly as possible, as well as support if you get stuck. Let's jump right in!


Email with Mailgun Sample App

Sending email from an app with Mailgun.

Sample app uses and demonstrates:

  • Ionic.
  • Server Code.
  • Invoking an external REST API.

App (UI)

To get the app UI:

  1. Create a new Ionic app based on the Blank template.
  2. Inside the App Builder, select Create new > From plugin. Under Examples, select Email with Mailgun.
  3. Click the Import selected plugin button.
  4. Select Screen1_Mailgun_Email_API as the starter page and click Apply settings.


To get the app backend:

  1. Go to Server Code page.
  2. Go to Plugins page.
  3. Import MailgunEmail plugin.

Mailgun Account

You also need to create a Mailgun account to get an API key to send emails. After you sign up for an account, you will need the following information:

  • Domain name in the form:
  • API key

This information can be found on this page and then by clicking on the active domain.

Configuring the Server Code Script

Now, you need to configure the script.

  1. Open the Server Code script you have just imported.
  2. At the top of the script, set the domain values.
  3. Then set the API key value (line 20).

That's all you need to do to configure this script.

Testing the Script

It's a good idea to test the script and the Mailgun API to make sure it works.

  1. Switch to Script parameters tab.
  2. Create the following three parameters and set them to test values:
    • to
    • subject
    • text
  3. Switch to Run tab and click Save and run button.

Connecting the App with the Backend

The last step is to connect the app with the backend.

  1. Inside the App Builder, open Services > MailgunEamil_service.
  2. In Settings tab, you will see {servercode} in the URL. To replace the value with the script ID, in Server Code script, switch to API information tab. There you will see the script ID in the URL you need to use.
  3. Save all the changes.

Testing the App

You are now ready to test the app. Click the Test button in the App Builder to launch the app in the browser.

Testing on the Device

You can also easily test the app directly on the device by using the Tester App

Email with Mailgun Sample App

Sending email from an app with Mailgun.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.