Nintex Forms O365 Quick Start

You can quickly and easily export, import, migrate, save, and publish forms from Nintex Forms for Office 365 by using the NintexForms for Office 365 REST API. The quick start provided here demonstrates the REST API, by walking you through the steps needed to export a Nintex form from SharePoint Online.

To use the API, establish your credentials and the endpoint. Use a REST client to contact the endpoints. The following quick start walks you through the following steps:

  1. Get the items you need before you work with the API
  2. Get your API key
  3. Working with the REST services
    1. Get your authentication cookie from SharePoint
    2. Collect your header information
    3. Construct a URL to reach the target endpoint

Get the items you need before you work with the API

Before you can begin you will need:

Get your API key

Once that's done, you need to request your API key and API URL from Nintex. The API key authorizes you to invoke the REST resources included with the REST API. You will need to use the API URL to connect to your API endpoints.. Without these, you can't authorize the REST API with your SharePoint site. You'll include the API key as a header value in every request that uses the REST API, as described in Authentication and authorization. You will need to use the API URL as the base URL described in Base URL.

Contact your Nintex representative to request an API key and API URL for the REST API.

Working with the REST services

The following section will look at using the REST service using HTTP calls in order to orient you to use the API. You must first get your authentication cookie from the SharePoint 0365 tenancy that you plan on working with. You can retrieve the authentication cookie via HTTP, with a .Net REST client, or by using Windows PowerShell.

Get your authentication cookie from SharePoint

Send the following information to the SharePoint to get your authentication cookie:

The cookie will have the following format: Cookie, Site URL, SPOIDCRL = cookiestring

With a .NET REST Client

You can find detailed code samples for C# in the Guide section which include five samples using Microsoft's HTTPClient library. The following code snippet highlights how these clients retrieve the authorization cookie:

  var login = "Username";

  var password = "password";

  var siteUrl = "siteURL";

  var creds = new SharePointOnlineCredentials(login, password);

  var auth = creds.AuthenticateAsync(new Uri(siteUrl), true);

  var request = (HttpWebRequest)WebRequest.Create(siteUrl);

  request.CookieContainer = auth.Result.CookieContainer;

   var result = (HttpWebResponse)request.GetResponse();

With Windows PowerShell

You can find a Windows PowerShell script that demonstrates how to use the GetAuthenticationCookie method to retrieve an authentication cookie for the SharePoint 0365 tenancy using the credentials. For more information see "Windows PowerShell" in Authentication and authorization.

Collect your header information

You will need the appropriate header information:

Construct a URL to reach the target endpoint

The URL uses the following format: domainofo365tenant/api/v1/forms/listid
For example, to retrieve a form, you would use the following URL:
https://crestan.com//api/v1/forms/6263627c-57a6-42d0-9c87-2232e4e1899d

Headers

Methods

The API supports the following methods:

Action HTTP Method URI
Get Form GET https://{APIURL}/api/v1/forms/{listID},{contentTypeID}
Import Form POST https://{APIURL}/api/v1/forms/{listID}
Save Form PUT https://{APIURL}/api/v1/forms/{listID}
Publish Form POST https://{APIURL}/api/v1/forms/{listID}/publish
Delete Form DELETE https://{APIURL}/api/v1/forms/{listID},{contentTypeID}

Next steps

The Guide provides practical information and examples for each REST resource and operation included with the REST API. Experiment with the examples provided in the Guide to get a better idea about how to use the REST API.

The API Reference contains an overview of the technical information you'll need to use the REST API, as well as detailed reference information about the REST resources, data types, request and response bodies, and other elements included with the REST API. The API Reference is the best place to answer technical questions about implementing the REST API

Related information

Guide

API Reference