Getting Started!

Step 1: Create a Game Project on

  1. Navigate to
  2. Find the 'New Game Project' panel and enter a title for your project.
  3. Click the 'Next' button.

Step 2*: Enable the Beta Dashboard

  1. From your new project page, click the 'API Tools' button to open your API Dashboard.
  2. The default dashboard will show settings for the old Newgrounds Flash API. You need to switch to the API by clicking 'Click here to use the API for this game!' link near the top of the page.
  3. You should now see the 'API Version 3 Beta (' dashboard.

*This step is required during the beta period and will eventually go away.

Step 3: Verify your App Settings

  1. At the top of the page is your basic 'App Information'. Make a note of your App ID, you will need it to use
  2. At the end of the page is a form for configuring your Encryption Settings. You might need to change these depending on what encryption methods are available in your platform. If your settings are correct (and you are using encryption), make a note of the highlighted encryption key.

Note: Most of the libraries are designed to use AES-128 encryption with base64 encoding, so you probably won't need to change these at all.

Step 4: Implement the API Into Your Game

Download the library for your platform (if available).

Platform Author Encryption Cipher Encryption Encoder
JavaScript/HTML5 (Official version) Josh Tuttle AES-128 Base64
Construct 2 (WebGL) rexrainbow AES-128 Base64
GameMaker Studio Raeldor AES-128 Base64
JavaScript/HTML5 wrapper KilledByAPixel AES-128 Base64
Unity3D (C#) Josh Tuttle AES-128 Base64
Haxe Geokureli AES-128 Base64
PHP Kees Van Beilen AES-128 Base64

Step 5: Learn how to use the API components works by sending messages to our API server that contain rules for executing components.

In programming terms, you can think of an API component as a remote function. These functions take parameters, execute, and return a result.

Consult the help documents for your library to learn how you can call a component, then check out the components list page to see what components are available to you.

If there is no library for your platform, you can communicate with the server directly.