In this example, I'll show you how to create a simple integration between ServiceNow Express and LeanKit using c-534.io platform.

This integration will create one LeanKit card when a new Incident will be created in ServiceNow Express.

In order to create this integration on your c-534.io account, you'll need to create one Microservice in c-534.io. If you want to know what a Microservice is please go ahead and read about it on our wiki page!

What you'll need to proceed:

• c-534.io account (you can sign up for a free trial)
• ServiceNow Express account (you can sign up for a free trial)
• LeanKit account (you can sign up for a free trial)

Let's start!

From LeanKit you will need to get your chosen Board Id and Lane Id where you want new cards to be created by the integration.

Here's how to do it:

1. To get your Board Id just open your LeanKit board (where you want new cards to be created) in a browser. You should see a similar url in your browsers' address bar:

https://{account_name}.leankit.com/Boards/View/{boardId}#workflow-view

Copy the {boardId} part e.g. into the text editor, you will need this later.

2. You will also need Lane Id from your LeanKit board and a Card Type Id. To get those please use this url:

Now you have everything what's needed from LeanKit.

To get started with this integration you will need to create one Microservice in c-534.io.

Here are the necessary steps to do that:

1. Import a ready Microservice code from our GitHub repository to your c-534.io account just by clicking this link. This Microservice task will be to create new cards in LeanKit when new Incidents would be created in ServiceNow Express. The keys "board_id" and "lane_id" you obtained during the LeanKit setup. Fill in those plus your LeanKit user name and password like in the green box below: .
2. Click "Save".
3. Now go to "Transformation" tab and fill in your desired Card Type Id from LeanKit you obtained during "LeanKit setup". This is the card type which will be created in LeanKit by the integration. .
4. After clicking the "Save" button the url in your browsers' bar will be updated with url of newly created Microservice. You will need the last part of this url (it's called "urlsafe"), e.g.:

https://app.c534.io/microservice/config/YOU_WILL_NEED_THIS_PART

Copy your urlsafe for later use. It will be needed during ServiceNow Express setup.

Now you are all set in c-534.io!

In ServiceNow Express you will need to create one Business Rule and one "REST message" definition. Let's start from the creation "REST message".

1. You will need endpoint url to create new "REST message". The endpoint you need to use should be:

https://prod-k534-lit534.appspot.com/rest-json/URLSAFE_OF_YOUR_MICROSERVICE

Because of ServiceNow Express limitation of endpoint maximum size, you will need to create short version of The endpoint url. Let's open TinyURL and paste long version of endpoint url as below: .

Then click "Make TinyURL".You will receive shorter version of The endpoint url:

http://tinyurl.com/short_alias

Copy the entire link.

2. Now add a new "REST message" definition

Fill in the endpoint with c-534.io shorter link copied earlier in this tutorial. .

3. Now you can click "Submit" to save newly created "REST message".

4. Click on you newly created "REST message" to configure it. Then on "HTTP Methods" section click on "post"

and fill inputs as below:

.

5. Now you can click "Update" to save newly created "REST message".

6. Add a new Business Rule in ServiceNow Express. It's like defining an action in response to new Incident created in ServiceNow Express.

7. Setup new Business Rule (fill in according to green boxes below):

8. Click "Submit" to save newly created Business Rule.

Now you can create a new Incident in ServiceNow Express, in a matter a couple of seconds you should see a new card created in LeanKit. If something went wrong don't hesitate and contact us. We will be glad to give you a hand!