Creating your first Onfleet task via the API

by Mariana Muniz

For new users, interacting with any APIs can be daunting, but knowing the basics of Onfleet's world class API can unlock boundless business potential for all levels of your organization. Learning how to integrate with Onfleet will provide tools simply not possible to manually execute within our dashboard. Incorporating high volumes of increasingly complex actions through our API will introduce a level of competitive sophistication that all modern delivery operations need in order to compete in today's landscape.

As a first step towards harnessing our API, today we will show you how to issue your first Onfleet API request to create a task. Throughout this 6-step tutorial, we will be using the Postman app to create a task. Postman is a free tool used to send requests and receive responses via API, including but not limited to, the Onfleet API. While there are other tools out there, this is a great (and FREE) place to start, so head on over and download Postman to complete the tutorial below. You won't regret it!

Once you have the Postman app installed on your machine, make sure you have provisioned an API key in your admin account on Onfleet. To set up your API key please follow this quick guide. With your API key and Postman set up - you can now get started!

1) Open Postman and select either Create Request or the small + symbol on the top toolbar:

2) Since you are going to create a task - you will want to select POST from the drop down menu before you enter your request. A POST request simply means to create something on the Onfleet API under your organization’s account:

Select the interaction method (POST is to create)

3) Once you have selected POST, you can then enter the request URL in the Request URL section. The URL we want to use here is https://onfleet.com/api/v2/tasks. This is what we call the tasks API endpoint, which is the target endpoint where we are creating the task on:

Request URL for the Task API endpoint

4) Now, you will need to set the Authorization to authenticate your request. Select the Authorization tab, then select Basic Auth from the drop-down (Onfleet uses Basic Authentication). Once you have selected Basic Authentication - enter your API key in the username:

Setting up authorization

5) Now you will enter the details of your task. These details will be placed within the Body section of Postman. Within the Body section, you will want to select raw format and the JSON option within the drop-down:

Selecting body type (raw JSON)
Great job so far! Now you get to customize the information you would like for you task. This may seem daunting, but it is truly a case of “fill in the blanks”.

As an example of the information that we will "fill into the blanks", let’s say I run a donut shop and have just received an order with the following information:

  • Customer: Bruce Wayne
  • Phone Number: +1-905-555-5555
  • Address: 30 Rockefeller Plaza; New York, NY 10112
  • Complete After: November 15, 2019
  • Order Notes: 1 dozen assorted donuts

Here is how the body would look in the POST request using the order information:

Body of the POST request

Note: For timestamps, Onfleet uses Unix epoch time format with millisecond precision. In this example, 1573776000000 here translates to November 15th, 2019 00:00 AM GMT time.

6) Now that we have set our request type (POST), our request URL (Task API endpoint), Authorization, and Task details (body), we can click Send to issue our request to the API:

Sending the request

If your request is successful, you will receive a 200 task status with your task information in the Response body:

Receiving a response


And you will be able to view the task on your Onfleet dashboard:

Task is created and visible via the Onfleet dashboard

Congratulations, you’ve successfully created your first task using the Onfleet API. There are so many more programmatic actions you can do within this general framework, but this should give you an idea of how your business can start by creating an Onfleet task! Imagine using this method to integrate your backend order management system and then creating thousands of tasks per day within Onfleet without any manual input from your team.

Of course with more experience, more parameters can be added to your body as you create your tasks, such as setting up proof-of-delivery, creating tasks in batches, setting up auto-assignment and many more. The possibilities are virtually endless.

Learn about how to do all that and more in our API doc!