Using Rest Assured to POST to a JSON REST Service with rest-assured

In my last few posts we went over getting started with rest-assured and how to get request using the new given, when, then syntax — now that we have some get request method examples under our belt I wanted to take a look at a few examples of using Rest-Assured to test JSON REST services using the POST method.

Setup – CouchDB

To make this example as easy as possible and not have to setup any sort of authentication, I'll use Apache couchDB. CouchDB is easy to install, stores data as JSON documents and has an easy-to-use API to interact with it. This makes it a great application to use to teach us more about REST testing rest-assured and JSON.

To install couchDB go to:

  2. Click on Download and choose the version you want to us
  3. Once it's installed, enter in a browser. This should bring up your local CouchDB Futton web site.
  4. Next, click on the Create Database and name it “restassured”

  1. Navigate back to Notice that restassured shows 0 docs.

You can also check out my SoapUI – How to Post Json to a Rest Service video for how to install couchDB.

Time to use Rest-Assured to Send a Post Request

For some reason, I had a hard time figuring out how to do this. Whatever the reason, I finally got it to work. Remember — I’m still learning this myself, and posting what I’m learning along the way. There may be better way of doing it, but for now I’m sharing what worked for me to hopefully help get you started if you’re also struggling to get the POST to work.

  • In your IDE, create a new java class named CouchDB_REST
  • Import the following:
import org.junit.Test;
import org.junit.Before;
import static com.jayway.restassured.RestAssured.expect;
import static org.hamcrest.Matchers.equalTo;
  • Create a public method named postExample
  • Add the junit @Test annotation above it.
	public void postExample()
	String myJson = "{\"name\":\"Jimi Hendrix\"}";
    	RestAssured.baseURI  = "";	

    	Response r = given()
    	body("{\"name\":\"Jimi Hendrix\"}").

    	String body = r.getBody().asString();

  • Right click on the and Run As>Junit Test
  • Your test should pass

  • Look for the id in the Console output:

  • Go back to couchDB:
  • Notice how your restassured now shows Number of Documents 1
  • Click on the restassured db link and notice how the ID under the key column matches the id returned in the java console

More Rest-Assured Post


REST-assured How to Check Response Times

REST Testing with Java Part Two: Getting Started with Rest-Assured

QAtester - September 3, 2014

Hi Joe
Thanks for the great explanation

I do have some questions though!
How do you got your myJSON string?
My Json code is huge and am unware how to format it to string
Here goes my JSON Code:

{“GuestOrder”:{“GuestOrderNumber”:”999456789″,”GuestFirstName”:”Abraham”,”GuestLastName”:”Doe”,”OriginatorCode”:”OMS”,”FulfillmentLocation”:”3303″,”EventDateTime”:”2012-12-10T11:10:20″,”MessageDateTime”:”2012-12-10T11:10:22″,”PriorityCode”:”storepickup”,”FulfillByDateTime”:”2012-12-10T11:11:22″,”StoreTransferOrderList”:{“StoreTransferOrder”:”101220009100″,”StoreTransferShipmentList”:{“StoreTransferShipment”:”8822700100″,”ReleaseNumber”:”98591069710444″,”ContainerList”:{“Container”:[{“ContainerNumber”:”9876544001″,”TrackingNumber”:”1Z123AB45CD6789001″,”ItemList”:{“Item”:{“TCIN”:”991238822″,”LineNumber”:”1″,”ShipmentLineNumber”:”1″,”Dept”:”123″,”Class”:”12″,”Item”:”1234″,”RequestedQTY”:”12″,”Notes”:”First Container First Item “}}},{“ContainerNumber”:”9876555200″,”TrackingNumber”:”1ZA819CD412L569200″,”ItemList”:{“Item”:[{“TCIN”:”119998888″,”LineNumber”:”2″,”ShipmentLineNumber”:”2″,”Dept”:”123″,”Class”:”12″,”Item”:”1234″,”RequestedQTY”:”12″,”Notes”:”second Container First Item “},{“TCIN”:”229998888″,”LineNumber”:”1″,”ShipmentLineNumber”:”3″,”Dept”:”9″,”Class”:”12″,”Item”:”99″,”RequestedQTY”:”12″,”Notes”:”second Container second Item “}]}}]}}}}}

s - February 22, 2015

Hi there,

How to add a tokenize header with a post request

balveer - August 11, 2015

i have a payload similar to

“createdBy”: “”,
“createdOn”: “2015-08-07T16:47:27.527+05:30”,
“id”: 500050,
“updatedBy”: “”,
“updatedOn”: “2015-08-11T12:35:29.606+05:30”,
“accountContexts”: [
“accountReferenceId”: “C00000003”,
“billPayer”: false,
“changePassword”: false,
“correspondenceAddress”: {
“createdBy”: “”,
“createdOn”: “2015-08-07T16:47:27.528+05:30”,
“id”: 500050,
“updatedBy”: “”,
“updatedOn”: “2015-08-07T16:47:27.528+05:30”,
“city”: “bangalore”,
“country”: “india”,
“postalCode”: “23167”,
“state”: “KA”,
“street”: “Sarjapur”
“emailAddress”: “”,
“name”: “”,
“parentInfo”: {
“createdBy”: “superadmin”,
“createdOn”: “2015-05-13T12:41:23.433+05:30”,
“id”: 1011,
“updatedBy”: “superadmin”,
“updatedOn”: “2015-05-13T12:41:23.433+05:30”,
“accountContexts”: [
“accountReferenceId”: “A1011”,
“billPayer”: true,
“emailAddress”: “”,
“name”: “EXCHANGE”,
“phoneNumber”: “9181818181”,
“representative”: false,
“state”: “ACTIVE”,
“typeId”: 1001,
“userName”: “”
“phoneNumber”: “234567”,
“representative”: false,
“state”: “OBSOLETE”,
“type”: {
“createdBy”: “”,
“createdOn”: “2015-08-07T12:53:04.048+05:30”,
“id”: 500000,
“updatedBy”: “”,
“updatedOn”: “2015-08-07T12:53:04.048+05:30”,
“name”: “CIM_USERS”,
“ownerName”: “EXCHANGE”
“useExternalAuthentication”: false,
“userName”: “”,
“password”: “Cisco_123”

could you please help me how to send above payload as post request.

Snigdha Kasimahanthi - August 3, 2016

With respect to the questions posted by Balveer and QA Tester,
you may want to create a class with all the required fields, instatiate it and then pass the object in the body.
Say from Balveer’s payload above, userName, accountReferenceID, updatedBy etc will constitute the fields, include getters and setters in the class for the fields, instantiate the class with an Object say payload_obj and pass it as an Object within the body.


Aminul - August 12, 2016

Add your file in the resource folder and call it using below code ..
URL file = Resources.getResource(“yourfile.json”);
String myJson = Resources.toString(file, Charsets.UTF_8);

Response responsedata = given().header(“Authorization”, AuthrztionValue)
.header(“X-App-Client-Id”, XappClintIDvalue).contentType(“application/vnd.api+json”).body(myJson).with()

.when().post(your URL)

Click here to add a comment

Leave a comment: