1. Tasks
eLogii
  • Introduction
  • Entities
  • FAQs
  • Query parameters
  • Webhooks
  • Tasks
    • Task Elements
    • Create or update many tasks
      POST
    • Get tasks
      GET
    • Create tasks
      POST
    • Delete tasks
      POST
    • Update a task
      PUT
    • Get Proof of Delivery
      GET
    • Cancel tasks
      POST
    • Create return task
      POST
    • Move tasks to another date
      POST
    • Tasks reattempt
      POST
    • Start tracking a task (webhook)
      POST
  • Drivers
    • Driver Elements
    • Create or update many drivers
      POST
    • Get drivers
      GET
    • Create drivers
      POST
    • Update drivers
      POST
    • Delete drivers
      POST
  • Customers
    • Customer Elements
    • Create or update many customers
      POST
    • Get customers
      GET
    • Create customers
      POST
    • Update customers
      POST
    • Delete customers
      POST
  • Depots
    • Depot Elements
    • Get depots
    • Create depots
    • Update depots
    • Delete depots
  • Driver-schedule-exceptions
    • Driver-schedule-exception elements
    • Get all exceptions
    • Get schedule exception for a specific driver
    • Update a schedule exception
    • Create multiple schedule exceptions
    • Delete multiple schedule exceptions
  • Route-template-groups
    • Route-template-groups elements
    • Get route template groups
    • Create a route-template-group
    • Update a route template group
    • Delete multiple route template groups
    • Schedule for dates
  • Routes
    • Route Elements
    • Get routes
    • Clear route(s)
    • Lock route(s)
    • Unlock route(s)
    • Set planned ETAs
    • Setting the task order
  • Task-template-groups
    • Task-template-groups Elements
    • Get task-template-groups
    • Create task-template-groups
    • Get one task-template-group by _id
    • Update task-template-group
    • Delete one task-template-group
    • Delete multiple task-template-groups
    • Schedule task-template-groups for dates
    • Add tasks to group
  • Vehicles
    • Vehicle Elements
    • Create or update many vehicles
    • Create vehicles
    • Get vehicles
    • Update vehicles
    • Delete vehicles
  • Zones
    • Zones Elements
    • Get zones
    • Create zones
    • Update a zone
    • Delete a zone
  • Optimization
    • Optimization Elements
    • Run optimization for provided data set
    • Run optimization for one or multiple dates
    • Run optimization for one or multiple existing routes
    • Optimize tasks in a period (e.g. 1 month), where some of the tasks have varying intervals - e.g. weekly, every 2 weeks, monthly
    • Run optimization for a date range
  • Forms
    • Get all forms
    • Create and design a form
    • Update forms
    • Delete forms
  • Form submissions
    • Get all form submissions
    • Get a specific form's submissions
    • Update form submissions
    • Delete form submissions
  1. Tasks

Create or update many tasks

Production
https://api-35.elogii.com
Production
https://api-35.elogii.com
POST
/tasks/createOrUpdateMany
The Create or Update Many endpoint is the most important task endpoint, as it satisfies all of your task creation and update processes.
The endpoint checks if the task already exists by matching either the uid, reference or externalID value with your records, and either updates the corresponding task if the fields match, or creates a new task if it doesn't exist. It also ensures that you don't create duplicate tasks or send multiple calls to eLogii.

Request

Authorization
Add parameter in header
Authorization
Example:
Authorization: ********************
Body Params application/json

Examples

Responses

🟢200Created a task
*/*
Successful
Body*/*

🟢200Updated a task
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api-35.elogii.com/tasks/createOrUpdateMany' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "items": [
        {
            "reference": "123-test",
            "type": 1,
            "date": 20250822,
            "timeWindows": [
                {
                    "start": 540,
                    "end": 900
                }
            ],
            "instructions": " Please leave outside workshop if closed",
            "location": {
                "type": 2,
                "name": "C0805-KD Fine Art (Compton)",
                "address": "The Old Pottery,Down Lane,Compton,Surrey,GU3 1DQ,GB",
                "postCode": "GU3 1DQ",
                "coordinates": [
                    -0.630083,
                    51.220836
                ]
            }
        }
    ],
    "importConfig": {
        "importMode": "update",
        "match": {
            "reference": true
        }
    }
}'
Response Response Example
200 - Created a task - Example 1
{
    "result": "1",
    "ids": [
        "68a83be20017daed57692807"
    ],
    "errors": [
        "string"
    ],
    "created": "1"
}
Modified at 2026-05-15 19:06:39
Previous
Task Elements
Next
Get tasks
Built with